如何配置Composer使用国内镜像以提升下载速度？

本文共计836个文字，预计阅读时间需要4分钟。

若镜像未配，大概率是配置错误了，或是被更高优先级的设置覆盖了。Composer的源有明确优先级：

• composer config -g repo.packagist 输出为空、null 或报错 → 说明命令根本没写对，常见错误包括：repos.packagist（多一个 s）、漏掉 composer 类型值、URL 少末尾 /、用了 http 而非 https
• 项目根目录存在 composer.json 且含 "repositories" 字段 → 全局配置自动失效，哪怕只写了 "repositories": {} 也会屏蔽镜像
• CI/CD 或宝塔后台用 www 用户执行命令 → -g 写的是 root 的 ~/.composer/config.json，但实际运行用户读不到
• 执行 composer diagnose，看输出中 Repo packagist.org: 后面是不是你设的镜像地址；如果不是，就确认没接管

composer config repo.packagist 项目级配置怎么写才安全？

适合团队协作和 Git 管控，但必须注意写法，否则会破坏已有私有源或导致 composer validate 失败。