全局配置必须用composer config --global命令写入，漏掉--global会误写入项目级配置；验证需composer config --global --list确认repo.packagist存在，且url末尾必须带/，否则404；ci需先--unset清理旧配置，composer 3.x+元数据源仅认全局配置。
全局配置不能靠发文件或改~/.composer/config.json同步
团队发一个 config.json 让所有人手动覆盖 ~/.composer/config.json，根本不可控。CI 容器没家目录、新成员漏执行、权限错（比如 root 写的但 PHP 进程以 www-data 跑）、多项目共用同一份配置导致冲突——这些都会让配置失效。更麻烦的是，手写 JSON 极易出错：少逗号、引号不闭合、用了单引号，后续所有 composer 命令直接报 JSON 解析失败。
必须用 composer config --global 命令写入，且带 --global 参数
漏掉 --global（或简写 -g）是最常见错误：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ 看似一样，其实默默写进了当前项目的 composer.json 的 config 字段，对全局无效。正确命令必须显式带参数：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否成功：运行 composer config --global --list，输出里要有 repo.packagist 项才算写对。首行 “Global configuration file” 显示的路径才是真实位置，别猜 ~/.composer/config.json ——它可能根本不存在，或只是旧版残留。
CI 和中台环境必须先清理旧全局配置
中台 CI 流水线（如 GitHub Actions）如果之前跑过带全局配置的构建，repo.packagist 可能被污染，导致镜像失效或 fallback 到官方源。标准做法是在 composer install 前加一步：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config --global --unset repos.packagist
这能确保每次构建都从干净状态开始。另外，cache-dir、bin-dir、github-oauth 这类字段只认全局配置，项目级 composer.json 里设了也无效——它们决定的是所有成员本地缓存位置和全局命令安装路径，不是某个项目的依赖行为。
Composer 3.x+ 的元数据源必须走全局配置，项目级 repositories 不生效
你把阿里云镜像写进 composer.json 的 repositories 数组，composer install 却还在卡在 provider-laravel~10.0.json 请求上？这不是配置没生效，而是 Composer 3.x+ 把 Packagist 元数据源（packages.json、所有 provider-*.json）当作硬编码单例处理，repositories 只影响私有源，不影响官方包的元数据请求路径。真正能覆盖这条路的，只有全局配置：
composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/
注意：url 末尾必须带 /，否则请求变成 https://mirrors.aliyun.com/composer/packages.json（404）。验证是否真走镜像，唯一可靠方式是看 composer update -vvv 日志里所有 p2/xxx/yyy.json 请求的域名——不是看 “Resolving dependencies” 那行，那只是开头。
