全局配置 Composer 国内镜像必须严格使用命令“composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/”，缺一不可：-g 参数、repo.packagist 键名（非 repos）、composer type 值及 HTTPS 末尾斜杠。
全局配置 Composer 国内镜像，一条命令就能生效，但 90% 的人配不成功——不是网络问题，是命令写错了三个硬性条件。
composer config -g repo.packagist 命令必须带齐三要素
这条命令不是“大概对就行”，漏掉任意一个都会静默失败：不报错、不提示、也不写入，查 composer config -g repo.packagist 时输出为空或仍是 https://packagist.org。
-
-g不能省：缺了就只改当前目录的composer.json，换项目立即失效 -
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） -
composer是 type 值，不是可选参数——省略后 Composer 2.0+ 会 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须用 HTTPS，且末尾斜杠/不能少（少斜杠会拼出/composerpackages.json导致 404）
✅ 正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
❌ 错误示例：composer config -g repos.packagist composer https://mirrors.aliyun.com/composer/（多一个 s）、composer config -g repo.packagist https://mirrors.aliyun.com/composer/（缺 type）、composer config -g repo.packagist composer http://mirrors.aliyun.com/composer/（HTTP 被拦截）
验证是否真的写进去了
别信“执行完就完事”，必须手动验证。运行：composer config -g repo.packagist
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 预期输出是完整 JSON 对象，例如：
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 如果返回空、
null、或报Key does not exist，说明没写进去，立刻检查拼写和斜杠 - 该配置实际写入
~/.composer/config.json（Linux/macOS）或%USERPROFILE%\AppData\Roaming\Composer\config.json（Windows），可直接打开文件确认
为什么全局配置在 CI 或宝塔里经常失效
全局配置依赖当前用户的 COMPOSER_HOME，但很多环境根本读不到你的配置：
- GitHub Actions 默认用
runner用户，不继承你本地的-g配置 - 宝塔面板默认以
www用户运行 PHP 和 Composer，跟你登录终端的用户不是同一个 - 团队协作时，新人拉代码后行为不一致——
-g配置无法被 Git 跟踪
解决办法：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g），它会自动往 composer.json 写入 "repositories" 字段，所有人 clone 后行为一致。
换源后还是卡在 “Resolving dependencies”？那和镜像无关
镜像只加速元数据拉取和 ZIP 包下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本可以确定是以下原因：
-
"php": "^7.4 || ^8.0"这类宽泛版本约束，让 Composer 尝试大量组合 - 用了太多未锁定的 dev 分支，比如
"monolog/monolog": "dev-main" -
require-dev里塞了 phpunit、psalm、phpstan 等一堆工具链，相互冲突
这种情况下，换腾讯云、清华、阿里任何镜像都没用——得去改 composer.json 的约束逻辑，或者加 --with-dependencies 缩小搜索空间。
