答案是90%的composer install失败源于网络链路或权限问题，需先验证dns（ping packagist.org）、确认镜像配置正确（composer config -g repo.packagist输出含https://mirrors.aliyun.com/composer/）、清缓存（composer clear-cache）、检查代理（http-proxy与https-proxy缺一不可）及修复目录归属（chown -r $user:$user vendor/ composer.lock）。
报错不是 Composer 坏了，而是网络链路在某一层断了——90% 的 composer install 失败，卡在连接、解析或权限上，和代码无关。
报 “Connection refused” 或 “cURL error 7” 怎么办
这说明请求根本没发出去，或发出去后对方没响应。不是 PHP 扩展没开（php -m | grep curl 能看到就 OK），也不是 Composer 版本低（composer --version ≥ 2.0 即可）。
- 先验证 DNS：
ping packagist.org，如果返回unknown host，说明 DNS 解析失败，该换 DNS（比如设为8.8.8.8）而不是调composer config - 确认是否用了镜像：
composer config -g repo.packagist，输出必须是https://mirrors.aliyun.com/composer/（注意是https，且末尾带/） - 换源后必须清缓存：
composer clear-cache，否则旧失败记录还在，重试照样走原地址 - 企业内网若走中间人代理，会静默触发连接拒绝；可临时验证：
composer config -g secure-http false+composer config -g cafile /dev/null（仅调试）
代理配了还是连不上？检查 https-proxy 是否漏设
Composer 对 http-proxy 和 https-proxy 是分开路由的：前者只用于 HTTP 请求，后者才用于 HTTPS 的 CONNECT 隧道。漏掉 https-proxy，实际请求仍被直连拦截或超时。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
https-proxy的值必须是http://开头（不是https://），即使代理本身监听 TLS 端口——这是 Composer 的硬性约定 - 命令要加
-g（等价于--global），否则只写入当前项目composer.json，换目录就失效 - 验证是否生效：
composer config -g --list | grep -E "(http|https)-proxy"，确认两行都存在且 URL 格式正确 - 填成
https://127.0.0.1:8080或漏协议头（如127.0.0.1:8080）会导致静默失败：没有错误提示，但所有 HTTPS 请求都 fallback 到直连，最终超时或 502
报 “Permission denied” 写 vendor/ 或 composer.lock
绝大多数不是缺权限，而是目录“认错了主人”——vendor/、composer.lock 或 ~/.composer 被 sudo 污染过，属主是 root，而你正以普通用户运行命令。
- 报错里带路径的那一行就是线索：
file_put_contents(/path/to/vendor/autoload.php): Permission denied→ 问题在vendor/ - 立刻检查归属：
ls -ld vendor/ composer.lock $(composer config -g home) - 修复归属：
sudo chown -R $USER:$USER vendor/ composer.lock $(composer config -g home)（别用chmod 777，那是掩耳盗铃） - Windows 下若提示
Could not write to file，检查%APPDATA%\Composer\config.json目录是否存在且可写
卡在 “Resolving dependencies” 就不动？这不是 timeout 问题
这一步根本没发 HTTP 请求，Composer 只是在查域名的 IP 地址。改 http.timeout 完全无效，纯属白等。
- 常见现象包括：
Could not resolve host、unknown host、ping packagist.org失败 - 先手动测 DNS：
dig mirrors.aliyun.com @114.114.114.114，看是否能返回正确 IP - 临时换系统 DNS：Linux/macOS 改
/etc/resolv.conf加nameserver 8.8.8.8；Windows 在网络适配器里手动设 - 检查
/etc/hosts（或C:\Windows\System32\drivers\etc\hosts）是否误写了错误的packagist.org映射 - 用手机热点试一次——很多企业网会屏蔽
packagist.org和github.com，但热点通常通
最常被忽略的点：镜像配置写错一个字符就等于没配，且静默失效，不报错也不提示；代理没配全（http-proxy 和 https-proxy 缺一不可）；以及 vendor/ 目录归属被 sudo 锁死——这三个问题加起来覆盖了 80% 的真实故障场景。
