composer config -g repo.packagist 静默失效是因为必须同时满足三个硬性条件：键名必须为单数 repo.packagist、第二个参数必须显式写 composer（type 值）、url 必须 https 且末尾带 /；任一错误即静默回退官方源，且不报错。
镜像源配置不生效，90% 是因为 composer config -g repo.packagist 命令写错了三个硬性细节，不是网络慢，是根本没走镜像。
为什么 composer config -g repo.packagist 总是静默失效
这条命令不报错、不提示失败，但只要错一个字符，Composer 就自动 fallback 到 https://packagist.org。常见错误包括：
-
repo.packagist写成repos.packagist（多一个s）→ Composer 完全忽略该字段 - 漏掉中间的
composer参数：例如composer config -g repo.packagist https://mirrors.aliyun.com/composer/→ 缺失type，配置无效 - URL 末尾缺
/：如https://mirrors.aliyun.com/composer→ 拼出错误路径/composerpackages.json，返回 404 - 用了 HTTP 而非 HTTPS：部分镜像站已停用 HTTP 支持，直接拒绝连接
验证是否真生效，只看这三处
别信“命令跑完了”，必须手动确认：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null、或仍是https://packagist.org都说明失败 - 进项目目录后执行
composer config repo.packagist，确认没有被项目级repositories字段覆盖（有输出即被覆盖） - 加
-vvv看真实请求：composer install -vvv 2>&1 | grep "Downloading"，域名必须是mirrors.aliyun.com或mirrors.tuna.tsinghua.edu.cn，不是packagist.org或api.github.com
配完镜像还卡着？清缓存 + 删锁文件 + 调并发
镜像只加速下载，不解决旧缓存和本地解析问题：
- 必须执行
composer clear-cache：否则 Composer 仍从缓存读旧packages.json，甚至尝试连已停用的phpcomposer.com - 删掉项目里的
composer.lock和vendor/目录：尤其首次配镜像时，lock文件里"dist": {"url": "github.com"}还是原始地址，不删就白配 - 调高并发下载数：
composer config -g http-max-concurrent-downloads 10（默认仅 3），国内带宽下不调等于没提速；超过 10 可能触发file_put_contents(/tmp/): failed to open stream错误，建议先试 6–8
宝塔、CI、Docker 里全局配置常不生效
你在终端用 root 执行了 composer config -g，但实际运行环境用的是其他用户：
- 宝塔后台以
www用户运行 → 它读的是/home/www/.composer/config.json，不是/root/.composer/config.json - CI 脚本用
sudo composer config -g→ 写进root配置，而 runner 用户无权读取 - 更稳妥做法：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（不加-g），它会安全追加到composer.json的repositories字段，可提交 Git，团队一致
最易被忽略的点：镜像只影响元数据拉取和 ZIP 下载，Resolving dependencies 卡住跟网络完全无关——那是本地求解器在穷举版本组合，得靠收紧 php 版本约束、避免 "*" 和 dev-main 来解决。
