Composer镜像配置失效的根本原因是命令错误导致静默失败：必须严格满足三要素——键名repo.packagist（单数小写）、type值显式为composer、URL以https://开头且末尾带/，缺一即回退官方源。
composer config -g repo.packagist 为什么总不生效
这条命令写错就等于没配，而且静默失败——不报错、不提示、install 还是卡在 Downloading https://packagist.org。关键必须同时满足三件事：
-
repo.packagist是唯一合法键名：写成repos.packagist（多 s）、Repositories.packagist（大小写）或repositories.packagist.org（Composer 2.2+ 新写法但和旧版不兼容）全无效 -
composer是必需的 type 值：不能省略，也不能当注释写在后面；漏掉它，Composer 2.0+ 会 fallback 到官方源 - URL 必须以
https://开头，且末尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（请求会拼成/composerpackages.json，直接 404）
验证是否真写进去了：运行 composer config -g repo.packagist，正确输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。返回空、null 或报错，说明配置根本没落盘。
项目级镜像配置比全局更可靠
全局配置看着省事，但在团队协作、CI/CD 或私有包场景下容易翻车：新人拉代码行为不一致、流水线里用户身份不同导致镜像不加载、"packagist.org": false 直接屏蔽全局设置。推荐进项目根目录执行：
-
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json顶层写入"repositories"字段，key 固定为"packagist"，不会覆盖已有私有源（前提是原repositories是对象，不是数组） - 务必加
"packagist.org": false，否则 Composer 仍会 fallback 到官方源，加速失效
改完建议删掉 vendor/ 和 composer.lock，再跑 composer install，确保依赖从新源拉取。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer install 失败时怎么捕获异常
composer install 本身不抛 PHP 异常，遇到网络超时、解析失败或权限错误，直接退出并返回非零状态码——你在 post-install-cmd 里写 try/catch 完全没用，回调函数根本不会执行。
- 真正能捕获的位置只有 shell 层：必须用 wrapper 脚本包裹命令，靠
exit code+stderr输出做判断 - 建一个
bin/composer-safe（记得chmod +x），核心逻辑是重定向 stderr 到临时文件，失败时读取内容触发上报（比如 curl 发到 Slack 或日志服务） -
set -e确保任意命令失败立即退出；别用||拼接，它会吞掉原始 exit code，CI 流水线可能误判成功
如果只是想跳过脚本干扰统一控制流程，加 --no-scripts 参数更干净。
换镜像后还是 Connection refused 或超时
90% 的 Connection refused 或 curl error 28 不是 Composer 配置问题，而是系统网络链路断在 DNS、防火墙或 TLS 握手层。先别调 Composer 参数，跑两行命令定位根因：
-
ping packagist.org：返回unknown host→ DNS 失败，换 DNS（如8.8.8.8） -
curl -I https://packagist.org：卡住或报Failed to connect→ 防火墙/代理拦截，切手机热点一试便知 -
curl -I https://mirrors.aliyun.com/composer/packages.json：返回非 200 → 镜像本身不可用，或本地 HTTPS 被杀毒软件劫持（360/火绒 常见）
确认网络通了再查 Composer 层：清缓存（composer clear-cache）、检查项目级 repositories 是否覆盖全局、确认 http.timeout 和 process-timeout 都已设够大（比如 600 和 1200）。prefer-source: true 会让镜像完全失效，因为镜像只代理 dist 包，不代理 git clone。
