cURL error 28 或 Operation timed out 是网络超时所致，主因是默认 HTTPS 访问 packagist.org 超过300秒未响应，常见于国内DNS慢、代理失效、防火墙拦截TLS或未配镜像；应优先配置阿里云/腾讯云镜像，再排查DNS、TLS握手及cURL详细日志。
Composer install/update 时提示 cURL error 28 或 Operation timed out
这是最典型的网络超时表现，根本原因不是 Composer 本身有问题，而是它默认通过 HTTPS 访问 packagist.org（或镜像），而你的网络无法在默认 300 秒内完成包元数据下载或 ZIP 文件拉取。
-
curl_setopt(): CURLOPT_TIMEOUT set to 300, but libcurl recommends setting CURLOPT_TIMEOUT_MS这类警告说明底层 cURL 已触发硬超时 - 常见于国内未配置镜像、代理未生效、DNS 解析缓慢、或企业防火墙拦截 TLS 握手的环境
- 别急着调大超时值——如果连
composer.json元数据都拉不下来，加时间只是让失败更慢
确认是否真为网络问题：用 curl 直接测 packagist 域名
绕过 Composer，验证底层网络是否通畅。执行以下命令：
curl -I https://packagist.org/packages.json
如果卡住或返回 Connection timed out，说明问题出在 DNS、路由或 TLS 层；如果返回 HTTP/2 200，那可能是 Composer 缓存损坏或镜像配置错误。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 试下换 DNS：
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf（Linux/macOS） - 加
-v参数看 Composer 实际请求地址：composer install -v，确认它连的是packagist.org还是镜像站 - 某些公司网络会拦截 SNI 扩展，可临时用
curl --resolve packagist.org:443:192.168.3.11绑定已知可用 IP 测试（IP 需先查最新）
国内用户优先配置阿里云或腾讯云 Composer 镜像
官方源在国内直连成功率低，镜像是最稳定解法。注意：必须全局设置，否则 composer.json 中的 repositories 字段可能被忽略。
- 全局启用阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应输出{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 若项目已存在
vendor/，先删掉再composer install；镜像不会加速已有包的 autoload 生成 - 腾讯云镜像地址是
https://mirrors.cloud.tencent.com/composer/，二者响应速度因地区而异，可挨个试
仍超时？调整 Composer 的超时与重试参数
仅当镜像也失效或需拉取私有包时才动这些参数。盲目加大 timeout 可能掩盖真实问题。
- 延长单次请求超时：
composer config -g process-timeout 3000（单位秒，默认 300） - 允许失败后重试：
composer config -g github-protocols ["https"]避免 SSH 协议卡死 - 禁用并行下载（降低并发压力）：
composer config -g disable-tls false不推荐；真正有效的是composer config -g bitbucket-oauth {"bitbucket.org": {"consumer-key": "", "consumer-secret": ""}}（私有库场景） - 终极调试：加
-vvv输出完整 cURL 请求头和重定向链，找卡在哪个 URL
超时背后常是 DNS 解析慢或 TLS 握手失败，而不是带宽不足。盯着 curl -v https://mirrors.aliyun.com/composer/packages.json 的耗时分布，比反复改 Composer 配置更有效。
