Composer卡在Loading或Downloading是因未同时配置http-proxy和https-proxy：二者必须均为http://开头且端口完整，缺一则HTTPS请求静默直连失败；验证需用composer config -g --list | grep -E "(http|https)-proxy"。
Composer 卡在 Loading composer repositories 或反复出现 Downloading https://api.github.com/，不是镜像没配对，而是根本没走代理——http-proxy 和 https-proxy 必须同时显式配置，缺一不可。
为什么只设 http-proxy 会静默失败
Composer 对 HTTP 和 HTTPS 请求路由完全分离：前者走 http-proxy，后者必须走 https-proxy 字段，且该字段值**必须是 http:// 开头的地址**（哪怕代理本身监听 TLS 端口）。漏掉 https-proxy，所有元数据请求（如 https://packagist.org/packages.json）都会 fallback 到直连，最终超时或卡住，日志里却无明确报错。
-
https-proxy填成https://127.0.0.1:7890或漏协议头（如127.0.0.1:7890）→ 静默忽略，等效于未配置 - 密码含
@、/、:必须 URL 编码，例如pa@ss/word→pa%40ss%2Fword - Windows 下若提示
Could not write to file，检查%APPDATA%\Composer\config.json是否可写
正确配置全局代理的命令
运行以下两条命令，确保两者都写入全局配置（~/.composer/config.json 或 %APPDATA%\Composer\config.json）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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.org.proxy http://127.0.0.1:7890 composer config -g repo.packagist.org.ssl-proxy http://127.0.0.1:7890
- 代理地址必须带端口，例如
http://127.0.0.1:7890；SOCKS5 仅 Composer ≥ 2.2 支持：socks5://127.0.0.1:7891 - 取消代理用：
composer config -g --unset repo.packagist.org.proxy和composer config -g --unset repo.packagist.org.ssl-proxy - 验证是否生效：
composer config -g --list | grep -E "(http|https)-proxy"，应输出两行且格式正确
代理配好仍卡住？快速定位三层故障点
现象一致，但问题可能在任意一层：
-
curl -x http://127.0.0.1:7890 -I https://packagist.org/packages.json返回407 Proxy Authentication Required→ 代理需 NTLM 认证，Composer 原生不支持，得用cntlm或px中转 -
curl正常但 Composer 卡住 → 检查是否误配了repo.packagist镜像源，代理和镜像不可共存，二者选一 -
curl也超时或No route to host→ 本地代理进程未启动、端口填错、或防火墙拦截
公司内网或 CI 场景下别硬上代理
阿里云、腾讯云等镜像站已提供完整同步且走内网直连，此时配代理反而多一层故障点。优先确认：
- 是否已运行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ -
composer install -vvv | grep "Loading composer repositories"输出中是否含mirrors.aliyun.com而非packagist.org - 若
composer.lock中 dist URL 仍是github.com，删 lock 文件再重试，否则镜像和代理都无效
真正卡点往往藏在 composer.lock 里固化的 GitHub ZIP 地址，而不是元数据加载阶段——代理只管 HTTPS 请求链路，不管 lock 文件里写死的下载路径。
