Gitee 不提供 Packagist 镜像服务，因其不支持 packages.json 接口与完整同步机制；国内可用镜像仅阿里云（https://mirrors.aliyun.com/composer/）和清华源（https://mirrors.tuna.tsinghua.edu.cn/composer/），推荐优先使用阿里云镜像并支持项目级配置。
为什么 composer config -g repo.packagist 设置 Gitee 镜像会失败
因为 Gitee 官方从未提供过完整、兼容 Packagist 协议的镜像服务。所谓“Gitee 镜像”实际是部分第三方维护的非官方代理（如 https://packagist.phpcomposer.com 已停用），或用户误将 Gitee 仓库当作了 Packagist 镜像源。Packagist 是 Composer 的默认元数据索引，必须由支持 packages.json 接口和完整同步机制的服务提供，而 Gitee 本身不具备该能力。
国内可用的稳定 Packagist 镜像有哪些
目前持续可用且同步及时的国产镜像只有两个主流选择：
-
https://packagist.org的官方中国镜像：https://packagist.phpcomposer.com（已停用）→ 现已迁移至https://packagist.laravel-china.org（注意：该域名已于 2023 年底停止服务） - 当前最可靠的是
https://mirrors.aliyun.com/composer/（阿里云镜像），它完整实现了 Packagist 协议，延迟低、同步快，且长期维护 - 清华大学镜像站也提供支持：
https://mirrors.tuna.tsinghua.edu.cn/composer/，但需确认其packages.json接口是否启用（部分时段会关闭以降低负载）
执行以下命令可全局切换为阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：
composer config -g repo.packagist
输出应为：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
项目级配置比全局配置更安全
全局镜像可能在某些企业内网或 CI 环境中引发依赖解析异常（例如私有包无法回退到原站）。推荐在项目根目录下单独配置：
- 进入项目目录后运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 该操作会写入项目下的
composer.json的repositories字段，不影响其他项目 - 如果项目已定义私有仓库，需确保
packagist条目排在repositories数组首位，否则可能被跳过
示例 composer.json 片段：
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
]
}
镜像失效时如何快速回退
镜像不可用时，Composer 通常报错类似：file_get_contents(): php_network_getaddresses: getaddrinfo failed 或 Failed to decode response: zlib_decode(): data error。此时不要反复重试，应立即切换回官方源：
- 全局回退：
composer config -g --unset repos.packagist - 项目级回退：
composer config --unset repos.packagist - 若已手动修改过
composer.json，直接删掉repositories中对应条目并运行composer update --lock
阿里云镜像虽稳定，但它的 packages.json 文件体积比官方大 20% 左右，首次运行 composer install 时内存占用更高，老旧 CI 机器可能 OOM——这点常被忽略。
