composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist、第二个参数必须显式写 composer（type 值）、URL 必须 HTTPS 且末尾带 /；任一不符即静默回退官方源，且不报错。
composer config -g repo.packagist 命令为什么总不生效
它不是“没反应”，而是静默失败——漏掉任意一个硬性条件，Composer 就当配置不存在，直接回退到官方源，连 warning 都不报。
必须同时满足这三点：
-
repo.packagist是唯一合法键名（注意是repo单数，写成repos.packagist或packagist.org全部无效） - 第二个参数
composer是type值，不是注释，不能省略，也不能写成composer.org - URL 必须是 HTTPS 且末尾带
/：比如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
验证是否真写进去了？别信终端没报错，直接运行：composer config -g repo.packagist。输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或提示 Key does not exist，说明根本没写成功。
项目级 repositories 配置为何常被忽略或误用
项目级配置写在 composer.json 里，优先级高于全局设置，但格式极其敏感，稍错就完全失效。
常见错误包括：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 把
"repositories"写成对象而非数组："repositories": {"packagist": {...}}→ Composer 直接忽略整段 - 没显式禁用官方源：
"packagist.org": false必须作为独立项放在composer.json根层级，不能塞进某个repositories对象里 - 执行
composer config repo.packagist composer ...（不加-g）会清空整个repositories字段，覆盖你已有的私有源 - 改完后不删
vendor/和composer.lock，composer install仍按旧文件拉取 dist URL，根本不会触发新镜像
Composer 2.2+ 和 3.x+ 的元数据请求机制差异
从 Composer 2.2 开始，packages.json 和所有 provider-*.json 请求就不再走 repositories 数组了——它们被当作全局单例硬编码处理。
这意味着：
- 你在
composer.json的repositories里加了阿里云镜像，对元数据请求完全无效 - 真正能覆盖元数据源的，只有
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ - Composer 3.x+ 更进一步：元数据请求 URL 拼接逻辑更严格，
/缺失会导致 404；且必须用 HTTPS，HTTP 地址在 2.9+ 已被拒绝 - 镜像不是代理，而是定时同步——首次请求某个
p2/laravel/framework/10.0.0.json时才触发拉取，所以可能遇到官方有、镜像返回 404 的情况
换源后仍卡在 Loading composer repositories 怎么快速定位
这不是网络问题，而是请求根本没发到你配的地址——Composer 还在用缓存或旧元数据。
排查顺序很关键：
- 先运行
composer diagnose，看Repo.packagist.org行是否显示为你配的镜像 URL - 再执行
composer clear-cache清掉本地缓存 - 用
curl -I https://mirrors.aliyun.com/composer/packages.json确认镜像站本身可访问且返回 200 - 如果仍失败，临时切中科大源：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn/composer/，验证是否为阿里云同步滞后所致
最易被忽略的是：镜像只加速网络 IO（如下载 packages.json、zip 包），不参与依赖解析逻辑。一旦卡在 Resolving dependencies，问题一定不在镜像，而在 composer.json 版本约束过宽或 autoload 配置错误。
