提升PHP学习效率，从配置Composer中文镜像开始！-composer-PHP中文网

composer镜像不生效主因是composer config -g repo.packagist命令写错：键名须为单数repo.packagist（非repos），composer为必填type值，url须https且末尾带/；任一错误均静默回退官方源，且宝塔/docker/ci中需按实际运行用户（如www）单独配置。

提升php学习效率，从配置composer中文镜像开始！

composer config -g repo.packagist 这条命令必须写对，否则镜像不生效——不是慢，是根本走不了国内源。

为什么配了镜像还是卡在 Downloading？

绝大多数情况不是镜像地址失效，而是 composer config -g repo.packagist 命令本身没写对，导致 Composer 静默回退到 https://packagist.org。它不报错，但你查不到任何异常。

repo.packagist 不能拼成 repos.packagist（多一个 s 就完全无效）
中间那个 composer 是 type 值，不是可选参数，漏掉就等于没设
URL 必须是 HTTPS + 末尾带斜杠：https://mirrors.aliyun.com/composer/ ✅，https://mirrors.aliyun.com/composer ❌
验证方式唯一：运行 composer config -g repo.packagist，输出必须是完整 URL 字符串或 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}

宝塔、Docker、CI 里全局配置为啥不生效？

因为 composer config -g 写的是当前用户的配置文件（比如 /root/.composer/config.json），而宝塔后台、Docker 容器、GitHub Actions 默认用的是 www、runner 或其他非 root 用户运行命令，根本读不到你配的全局镜像。

查实际执行用户：在宝塔终端里运行 whoami，或看日志里的 UID
给 www 用户单独配：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
CI 场景更推荐项目级配置，或用环境变量：COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install
别信“我配过一次就全好了”，不同用户、不同容器、不同部署方式，都要各自确认

项目级配置怎么安全追加，不覆盖私有源？

进项目根目录后，直接运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g）。这条命令会自动往 composer.json 的 repositories 字段里合并新项，前提是格式正确。