composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist、第三参数必须显式写 composer（type 值）、url 必须 https 且末尾带 /，缺一即静默回退官方源；验证需输出完整 json 对象。
报错八成不是网络差、PHP坏或你手慢，是镜像根本没配对——漏一个斜杠、少个composer参数、键名写成repos.packagist，它就安静退回https://packagist.org，连警告都不给。
composer config -g repo.packagist 为什么总不生效
这不是 Composer 抽风，而是三个硬性条件必须同时满足，缺一即静默 fallback：
-
repo.packagist是唯一合法键名（注意是repo单数，不是repos或repositories） - 第三参数必须显式写
composer，表示 type 值；写成composer config -g repo.packagist https://mirrors.aliyun.com/composer/就无效 - URL 必须是 HTTPS 且末尾带
/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼成/composerpackages.json导致 404）
验证是否真写进去了：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、只返回原始 URL 字符串，都说明失败。
换源后仍卡在 “Downloading” 或 “Loading composer repositories”
镜像只加速元数据和 ZIP 包拉取，但前提是它真被用了。常见静默 fallback 场景：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 项目级
composer.json里已有"repositories"字段（哪怕只是空数组[]），全局配置会被完全忽略 - 没清缓存：
composer clear-cache必须执行，否则旧的packages.json路径还在缓存里 -
composer.lock里记录的是原packagist.org的 dist URL，得删掉vendor/和composer.lock再跑composer install -vvv - 日志第一行才是真相：
composer install -vvv | head -n 15，看到的Downloading https://xxx才是真实请求地址——只看composer config输出没用
宝塔、Docker 或 GitHub Actions 里全局配置为啥不生效
全局配置写在 ~/.composer/config.json，但它只对「执行命令的用户」生效：
- 宝塔「一键部署」默认以
www用户运行，而你在终端用root执行的composer config -g写进了/root/.composer/config.json，www根本读不到 - 先确认实际执行用户：
whoami或查日志 UID；然后用对应用户重配，例如：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - CI 脚本中，确保
composer config -g和后续composer install使用同一用户（常见错误是前面用sudo，后面普通用户跑） -
sudo composer config -g后普通用户不能继承配置——Composer 不跨用户共享
项目级配置怎么安全写进 composer.json
团队协作或 CI 中，项目级配置比全局更可靠，它写进 composer.json，拉代码即生效：
- 进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 该命令会自动向
composer.json的"repositories"字段追加"packagist"条目，不覆盖已有私有源 - 如果
composer.json原本是"repositories": {}，命令会转为标准数组格式并插入；如果是"repositories": []，需先手动改成对象再执行，否则报错 - 改完务必运行：
composer update --lock，让composer.lock记录新源地址
最易被忽略的一点：镜像只管下载快不快，不管 Resolving dependencies 卡多久——那属于依赖解析层，和源地址无关，得从 PHP 版本约束、dev 包数量、锁版本策略去调。
