gitee 官方不提供 packagist 协议兼容的镜像服务，composer config -g repo.packagist 设置成 gitee 地址必然失败；它缺失 packages.json 接口、不支持元数据全量同步、也不托管 dist zip 包，而这三项是 composer 镜像的硬性门槛。
Gitee 不能作为 Composer 镜像源
直接说结论：Gitee 官方不提供 Packagist 协议兼容的镜像服务，composer config -g repo.packagist 设置成 Gitee 地址必然失败。它没有 packages.json 接口、不支持元数据全量同步、也不托管 dist ZIP 包——这三项是 Composer 镜像的硬性门槛。
你看到的所谓“Gitee 镜像”链接（比如 https://packagist.phpcomposer.com 或旧版 https://packagist.laravel-china.org），要么已停用，要么是第三方非官方代理，稳定性与同步时效均无保障。当前唯一可信赖的国产 Composer 镜像只有两个：https://mirrors.aliyun.com/composer/ 和 https://mirrors.tuna.tsinghua.edu.cn/composer/。
为什么 composer config -g repo.packagist https://gitee.com/xxx 总是静默回退
Composer 2.x+ 对 repo.packagist 配置极其严格，任何格式偏差都会导致 fallback 到 https://packagist.org，且不报错、不提示：
-
repo.packagist键名写成repos.packagist（多一个 s）→ 失效 - 命令中漏掉
composer这个 type 值 → Composer 忽略整条配置 - URL 缺少末尾
/（如写成https://mirrors.aliyun.com/composer）→ 拼出错误路径，返回 404，自动降级 - 输出
composer config -g repo.packagist是空、null或纯字符串而非完整 JSON（如{"type": "composer", "url": "..."}）→ 说明根本没写入成功
想用 Gitee 加速？必须分层处理
Cloning 卡住、Downloading https://api.github.com/ 慢，问题 100% 出在 Git 层，和 Packagist 镜像完全无关。此时该动的是 Git 配置，不是 Composer：
使用四维度框架评估任意 GitLab MR 或 GitHub PR 的复杂度：规模（20%），认知负荷（30%），审查工作量（30%），风险/影响（20%）...
- 把 GitHub 仓库地址手动替换成 Gitee 镜像地址（如
https://github.com/laravel/framework.git→https://gitee.com/mirrors/laravel-framework.git），并确认该镜像为公开、已同步、且未被限流 - 私有仓库必须走 SSH 协议（如
git@gitee.com:your-org/private-pkg.git），并确保ssh-agent已加载密钥 - 全局调优 Git 超时参数：
git config --global http.postBuffer 524288000、git config --global http.lowSpeedLimit 0、git config --global http.lowSpeedTime 9999 - CI/CD 中若用 HTTPS 克隆，需通过
GIT_TOKEN注入环境变量，不能硬编码密码或 Token 到composer.json
dev 分支依赖无法走镜像，这是设计使然
Composer 对 dev-main、dev-develop 这类开发分支的解析逻辑决定了它必须直连原始 Git 仓库（GitHub/GitLab/Gitee），镜像站不参与、也无法代理。验证很简单：composer install -vvv | grep Cloning，只要日志里出现 Cloning https://github.com/，就说明镜像完全没生效——这不是配置问题，是协议限制。
更现实的做法是：
- 把
dev-main替换为具体 commit hash（如9a8b7c6），Composer 会尝试从 packagist 的 dist 缓存拉 zipball，此时阿里云镜像才起作用 - 必须长期依赖 dev 分支？建议 fork 到公司内网 GitLab，再通过
"type": "vcs"配私有源，彻底脱离 GitHub 依赖 - 别在
repositories里写死 Gitee URL 并设"type": "composer"——这种组合无效，Composer 只查packages.json，而开发分支信息不在其中
真正容易被忽略的点是：镜像只管元数据和 dist 包，Git clone 是另一套系统；混用、漏配、或期待“一键同步所有环节”，只会让你反复卡在同一个地方。
