必须配置阿里云镜像源解决90%下载问题，命令需严格满足四要素：键名repo.packagist、type值composer、https且末尾带/、加-g参数；验证须用composer clear-cache后-vvv日志确认mirrors.aliyun.com出现。
国内用 Composer 时下载慢、超时、404，根本不是网络差，而是默认走 https://packagist.org，这个域名在国内解析和连接都不稳定。直接配阿里云镜像源就能解决 90% 的问题，但很多人配了没生效，是因为命令写错、路径不对或被项目级配置覆盖。
composer config -g repo.packagist 必须带全四要素
这条命令不是“大概对就行”，漏一个就静默失败，不报错也不提示：
-
repo.packagist是唯一合法键名（不能是repos.packagist或repositories.packagist.org） -
composer是强制 type 值，必须显式写出，不能省略 - URL 必须是 HTTPS 且以
/结尾，比如https://mirrors.aliyun.com/composer/（少斜杠会请求/composerpackages.json，404 后退回到官方源） - 必须加
-g，否则写进当前项目的composer.json的config字段里，完全不生效
正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证镜像是否真在用，别信 config -g 输出
composer config -g repo.packagist 只显示你“写了什么”，不代表 Composer 正在用它。真正生效要看实际网络行为：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清缓存：
composer clear-cache - 再执行真实操作：
composer require monolog/monolog -vvv 2>&1 | grep "Downloading" - 看到
https://mirrors.aliyun.com/composer/packages.json才算成功；如果还是packagist.org或repo.packagist.org，说明被项目级repositories覆盖了 - 更可靠的检查方式：
composer diagnose，看Repo packagist.org:那一行显示的 URL
老项目加镜像容易触发 Could not find package 错误
PHP 7.4 及以下、composer.lock 里含 packagist.org 哈希的老项目，不能直接加 "repositories": [] 数组——Composer 2.2+ 会启用隐式兜底逻辑，去镜像查旧包，而镜像往往没同步 v3.4 这类老版本。
正确做法是禁用兜底，强制走 lock 文件里记录的原始 dist URL：
- 运行：
composer config repositories.packagist.org false - 这会在
composer.json写入"repositories": {"packagist.org": false} - 注意：如果已有空数组
"repositories": []，得先手动改成空对象"repositories": {}再执行
跨系统（Windows/macOS/Linux/WSL）配置不一致的根本原因
同一套命令，在不同系统上行为不一，常见于 CI 卡住、WSL 重启后失效、Git Bash 写配置失败等现象，核心是路径和权限混乱：
- Composer 不读
~/.composer/config.json（旧路径），只认$COMPOSER_HOME指向的位置；Linux/macOS 默认是~/.config/composer/config.json，Windows 是%APPDATA%\Composer\config.json - Git Bash 中执行
composer config --global，%APPDATA%不展开，写入失败却不提示 - CI 容器常挂载空
/root/.composer，退回到默认源；而本地开发机可能早配好了镜像 - 解决方案：CI 中显式设路径，例如
export COMPOSER_HOME="/tmp/composer" && composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
最易被忽略的是：composer.lock 里的 dist URL 是硬编码的，一旦镜像没同步对应版本，又没禁用兜底，就会直接报错——这不是配置问题，是镜像源本身的数据覆盖范围限制。
