Composer国内安装慢或超时是因直连packagist.org存在DNS污染、连接不稳定及TLS握手失败；切换阿里云等镜像源可将元数据和ZIP包重定向至国内节点，不改逻辑且不影响依赖解析。
为什么 Composer 安装包特别慢或直接超时
国内直连 packagist.org 通常会遭遇 DNS 污染、连接不稳定或 TLS 握手失败，表现为 Could not resolve host: packagist.org 或卡在 Downloading https://packagist.org/packages.json。这不是你网络差，是默认源物理距离远 + 中间链路质量差。
切换镜像源本质是把 packagist.org 的元数据和 ZIP 包重定向到国内缓存节点，不改任何代码逻辑，也不影响依赖解析结果。
全局切换为阿里云镜像（推荐新手）
执行一条命令即可生效，后续所有项目都走镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否成功：
composer config -g repo.packagist
输出应为 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。注意：-g 表示全局配置，写入 ~/.composer/config.json；如果已存在自定义源，该命令会覆盖它。
- 阿里云镜像同步延迟约 5–10 分钟，不影响日常开发
- 不支持私有包（如企业内网 GitLab），如有这类需求需单独配置
repositories - 若公司防火墙拦截了 HTTPS 请求，可临时换用 HTTP 镜像（不推荐长期使用）：
http://mirrors.aliyun.com/composer/
仅当前项目使用腾讯云镜像（适合多源协作）
进入项目根目录后运行（不加 -g）：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer config repo.packagist composer https://mirrors.cloud.tencent.com/composer/
这条命令会修改项目下的 composer.json，新增 repositories 字段。好处是团队成员 clone 后无需再手动配置，坏处是可能和 CI/CD 流水线中的镜像策略冲突。
常见误操作：
- 误加
-g导致全局被覆盖，影响其他项目 - 重复执行导致
composer.json出现多个repo.packagist条目（Composer 只认第一个） - 用
composer config --unset清除时未指定作用域，删错了全局配置
恢复默认源或排查失败原因
切回官方源只需删除对应配置项：
composer config -g --unset repos.packagist
如果切换后仍无法安装，优先检查：
- 是否因镜像站维护导致 503（可访问
https://mirrors.aliyun.com/composer/packages.json直接测试） - 是否启用了代理且与镜像源冲突（
composer config -g http-proxy查看） - 是否在
composer.json中硬编码了repositories，覆盖了 config 设置 - PHP cURL 扩展是否禁用了 SSL 验证（某些旧系统会设
curl.cainfo错误路径）
镜像不是万能的——当包本身使用 dist 的 GitHub URL（而非镜像托管 ZIP）时，Composer 仍会直连 GitHub，此时需额外处理 GitHub 访问问题。
