composer config -g repo.packagist 命令不生效是因为未同时满足三个硬性条件：键名必须为单数 repo.packagist（非 repos）、第三参数 composer 为必需 type 值（不可省略）、url 必须是 https 且末尾带 /；任一缺失即静默回退至 https://packagist.org，验证需执行 composer config -g repo.packagist 并确认输出为完整 json 对象。
composer config -g repo.packagist 命令为什么总不生效
不是镜像源挂了，是命令漏了三个硬性要素就静默回退到 https://packagist.org，连错误都不报。你执行完觉得“配好了”，但 composer install -vvv 日志里全是 GET https://packagist.org/，说明根本没走镜像。
必须同时满足：
-
repo.packagist键名不能写成repos.packagist（多一个 s 就彻底失效） - 中间的
composer是type值，不是可选参数，漏掉它 Composer 2.x 直接忽略整条配置 -
https://mirrors.aliyun.com/composer/必须带末尾斜杠/，少一个会拼出/composerpackages.json导致 404 - 协议必须是
https://，HTTP 地址在 Composer 2.9.6+ 中默认被拒绝
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象（如 {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}），空、null 或仍显示官方地址，就是失败。
宝塔、CI、Docker 里镜像失效的真实原因
你在终端用 root 执行了 composer config -g，但宝塔后台跑的是 www 用户，GitHub Actions 用的是 runner 用户，Docker 容器里可能是 www-data ——它们读的都是各自家目录下的 ~/.composer/config.json，完全看不到你的配置。
查清实际用户再配：
- 宝塔终端里先运行
whoami，确认是www还是其他用户 - 然后用
sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本里别依赖全局配置，改用临时参数更可靠：
composer install --repository-url=https://mirrors.aliyun.com/composer/
Windows 用户改完需重启终端，否则缓存和环境变量不会刷新。
ThinkPHP 项目该用全局还是项目级配置
ThinkPHP 项目（尤其是 TP6/TP8 脚手架生成的）默认会在 composer.json 里带空的 "repositories": {} 或已有私有源。此时全局配置会被完全屏蔽——不是优先级低，是直接跳过，且不提示。
推荐进项目根目录（含 composer.json），执行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
这条命令会安全合并进 repositories 对象，前提是 composer.json 里的 repositories 是对象格式（{}），不是数组（[]）。如果是数组，命令会失败，得先手动改成对象再执行。
项目级配置的好处：提交到 Git 后协作者拉代码即用；CI 流水线无需额外操作；避免不同项目对镜像策略要求冲突（比如某项目要审计必须走官方源）。
换镜像后依然卡住或报错，该清什么
镜像只加速下载阶段（Downloading），不解决依赖解析（Resolving dependencies）、PHP 扩展缺失或缓存污染问题。
必须做三件事：
- 运行
composer clear-cache：旧缓存里存的是官方源 URL 和 hash，不清掉，composer update仍可能校验失败 - 删掉项目下的
vendor/和composer.lock：lock 文件里的 hash 来自旧源，和镜像元数据不匹配会导致安装中断 - 再跑
composer install -vvv，盯着日志看请求域名是不是mirrors.aliyun.com——这才是唯一可信的验证方式
特别注意：如果项目 composer.json 里写了 "packagist.org": false，会直接屏蔽所有镜像，得手动删掉或改成 true。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
