composer config -g repo.packagist 失效主因是键名错（必须单数repo）、缺type值“composer”、url末尾无/，三者任一出错均静默回退官方源，且需执行clear-cache并验证输出为完整json。
配错 repo.packagist 键名、漏掉 composer 类型参数、URL 少斜杠——这三处任一出错，Composer 就静默 fallback 到 packagist.org，不报错也不提示，你只会看到卡在 Downloading 或直接超时。
为什么 composer config -g repo.packagist 总是没效果
90% 的失败不是网络问题，而是命令写错了但 Composer 不报错。它只认三个硬条件：
-
repo.packagist不能写成repos.packagist或repositories.packagist—— 多一个s就失效 - 中间那个
composer是type值，必须显式写出：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，漏掉就等于没配 - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出 404）
验证是否生效：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象或纯 URL 字符串，内容含 mirrors.aliyun.com 或 mirrors.tuna.tsinghua.edu.cn；空、null、或仍是 https://packagist.org，说明根本没写进去。
宝塔、CI、Docker 里镜像不生效？用户权限搞错了
宝塔默认用 www 用户执行命令，而你在终端里用 root 配的全局配置，www 根本读不到。
- 查实际执行用户：
sudo -u www whoami或看宝塔日志里的 UID - 给对应用户重配：
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI/CD 或 Docker 构建中，别依赖全局配置，改用临时参数更可靠：
composer install --repository-url=https://mirrors.aliyun.com/composer/
项目级配置怎么安全追加，不覆盖私有源
进项目根目录后运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意不加 -g），这条命令会自动合并到 composer.json 的 repositories 字段里，不会清空已有 Git 私有源。
- 如果
composer.json原本是"repositories": {}，命令会转为标准数组并插入 packagist 条目 - 如果原本是
"repositories": [ ... ]，命令会在数组末尾追加新项 - 千万别手动编辑 JSON——格式错一个逗号或引号，
composer install直接报错 - 改完必须删掉
vendor/和composer.lock，再跑composer install，否则旧缓存和 lock 文件会触发 hash mismatch
换源后还是卡在 Downloading？不是镜像没走，是缓存没清
旧缓存里存着 packagist.org 的元数据，Composer 优先读缓存并尝试从旧地址校验，结果卡在 DNS 或 TLS 握手——请求根本没发出去。
- 先清缓存：
composer clear-cache - 删干净：
rm -rf vendor composer.lock - 强制走新源：
composer install --no-cache - 验证真走镜像：
composer show monolog/monolog -vvv 2>&1 | grep "Downloading"，日志里必须出现mirrors.aliyun.com，看到packagist.org就说明 fallback 了
镜像只解决下载环节，composer update 卡在 Resolving dependencies 是本地解析问题，和镜像无关；403 rate limit 是 GitHub Token 没配，得补 composer config -g github-oauth.github.com your_token_here。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
