composer镜像配置失效主因是三个硬性条件缺一不可：键名必须为单数repo.packagist、中间参数必须显式写composer、url必须https且末尾带/；任一缺失即静默回退官方源，验证需输出完整json对象。
直接换镜像源 + 调高超时 + 强制 IPv4，三步做完基本不卡。90% 的“加载失败”不是网络断了，是 Composer 默认等 30 秒就放弃、300 秒就报 cURL error 28，而国内镜像响应慢一点就直接跪。
为什么 composer config -g repo.packagist 总是没生效
这条命令静默失败率极高——不报错，但配置根本没写进 ~/.composer/config.json。必须同时满足三个硬性条件：
-
repo.packagist是单数，写成repos.packagist或repositories.packagist.org都无效 - 中间的
composer是 type 值，不能省略，也不能替换成 URL 或注释 - URL 必须以
https://开头，且末尾带/：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（会拼出/composer/packages.json，直接 404）
验证是否真生效：运行 composer config -g repo.packagist，输出必须是完整 JSON，例如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果只是字符串、null、空值，或还是 https://packagist.org，说明没配对。
composer install 卡在 “Loading composer repositories” 怎么办
这不是 Composer 没切源，而是系统层面连不上镜像域名——常见于 DNS 解析慢、TLS 握手卡住、WSL2 时间不同步，或公司代理拦截。典型错误是 Could not resolve host mirrors.aliyun.com 或 * TLS handshake timed out。
先验证连通性：curl -v https://mirrors.aliyun.com/composer/packages.json，看停在哪一步：
- 卡在
Resolving：改 DNS（如设为8.8.8.8）或临时绑定/etc/hosts（查nslookup mirrors.aliyun.com得 IP 后写入） - 卡在
TLS handshake：检查系统时间（date），WSL2 用户需同步 Windows 时间；内网可信环境可临时禁用证书验证：composer config -g secure-http false
超时参数到底该设多少：process-timeout vs http-basic-timeout
这两个参数作用层完全不同，混调等于白调：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
process-timeout控制整个命令生命周期（含依赖解析、下载、解压），默认 300 秒；建议设为1800（30 分钟） -
http-basic-timeout控制单次 HTTP 请求连接/读取时限，默认 60 秒；建议设为300（5 分钟），仅 Composer 2.2+ 支持 - 旧版本（如 2.1.x）不认
http-basic-timeout，只能靠process-timeout和换镜像硬扛
永久生效命令：
composer config -g process-timeout 1800 composer config -g http-basic-timeout 300
注意：http-basic-timeout=0 表示不限时，不建议，可能卡死无响应。
项目里有 "repositories" 字段时镜像还生效吗
完全不生效。项目级 repositories 字段会彻底屏蔽全局镜像配置，哪怕你 composer config -g repo.packagist 写得再对，只要 composer.json 里有 "repositories" 数组，它就优先读那个。
检查方法：composer config repositories，输出为空才安全；非空则需手动清理冗余项，尤其注意 Laravel Mix、Symfony bundle 等常硬编码源地址。
最常被忽略的点是：私有 Git 仓库（git@ 或 https://github.com/xxx）根本不会走镜像，换源对它们无效——这类失败必须单独处理，比如提前 clone 或改用 HTTPS + token。
