composer config -g repo.packagist 命令生效需同时满足三个条件：键名必须为 repo.packagist（不可复数或替换）、type 值强制为 composer、url 必须是 https 且末尾带 /；验证需输出完整 json 对象，否则未写入成功。
composer config -g repo.packagist 命令为什么总不生效
不是网络问题，也不是权限不足，而是命令里三个硬性条件缺一不可：键名必须是 repo.packagist（单数，不能写成 repos.packagist 或 packagist.org），中间的 composer 是强制 type 值（不是可选参数，也不能省略或替换成其他字符串），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 或只有一行 URL 字符串（新版行为），说明根本没写进去。
全局配置和项目级配置该用哪个
全局配置写进 ~/.composer/config.json，影响所有项目；项目级配置写进当前目录的 composer.json 的 repositories 字段，只作用于本项目。
- 个人开发机日常使用，优先执行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 团队协作、CI/CD、宝塔或 Docker 环境，必须用项目级：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 注意：
composer config repo.packagist会**完全覆盖**整个repositories字段——已有私有仓库配置会被清空，不是追加
换源后还是卡在 Loading composer repositories？
镜像只改下载路径，不解决缓存、锁文件或环境问题。卡住时先排除这几点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer clear-cache清掉本地缓存 - 删掉项目下的
vendor/和composer.lock - 确认 PHP CLI 环境启用
proc_open和putenv（查php.ini中disable_functions，删掉它们再重启 PHP-FPM/Apache/Nginx） - 检查是否被项目级
repositories字段覆盖：打开composer.json，搜"repositories"，哪怕只写了{"packagist.org": false}也会让全局镜像失效
Composer 2.2+ 推荐用 repos.packagist.org
新版更倾向用规范键名 repos.packagist.org 替代旧的 repo.packagist，尤其在处理子域名 fallback 或自定义 metadata 包时更可靠。
对应命令是：composer config -g repositories.packagist.org '{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}'
注意：第二个参数必须是完整 JSON 字符串，不能只传 URL，否则报错 Invalid repository type。旧命令仍兼容，但遇到某些 edge case 容易静默回退。
真正容易被忽略的是：配完镜像之后，composer.lock 里还存着旧源地址，vendor/ 里可能混着不同源拉下来的包——不删不重装，就永远在“半生效”状态。
