必须切换国内镜像源，执行composer config -g repo.packagist确认URL为https://mirrors.aliyun.com/composer/，再运行composer clear-cache并用composer install -vvv验证日志中是否出现镜像域名。
Composer 默认走国外源，国内直连经常超时或卡死，composer install 卡在 Downloading... 或报 Connection timed out 就是典型信号——这时候不是网络问题，是源没切对。
怎么快速确认当前用的是哪个源
执行这条命令就能看到真实生效的源：
composer config -g repo.packagist
如果输出是 {"type": "composer", "url": "https://packagist.org"}，说明还在用官方源；如果是 https://packagist.phpcomposer.com（已停用）或 https://mirrors.aliyun.com/composer/，说明已配置过镜像。
- 旧版阿里云镜像（
phpcomposer.com）2022 年起已下线，继续用会返回 404 - 清华、腾讯、阿里目前都可用，但阿里云镜像需注意 URL 末尾带斜杠：
https://mirrors.aliyun.com/composer/，少写会 404 - 全局配置（
-g）优先级高于项目级，改之前先看清楚作用域
三行命令搞定全局代理源切换
推荐用阿里云镜像，稳定且同步及时。以下命令直接覆盖全局配置：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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 composer https://mirrors.aliyun.com/composer/
注意这里 composer 是 type 字段值，不能省略，否则会误设为仓库名而非源类型。
- 如果只想临时换源（比如调试某个项目），去掉
-g，在项目根目录运行即可 - 执行后可立刻验证：
composer config -g repo.packagist，确认 URL 和 type 都正确 - 若提示
Failed to update packages.json，大概率是网络还没通，先ping mirrors.aliyun.com看 DNS 和连通性
HTTPS 证书错误或 CA 不信任怎么办
某些内网环境或老旧系统（如 CentOS 6、macOS 旧版 OpenSSL）会报 cURL error 60: SSL certificate problem，本质是 Composer 内置的 cURL 没法校验镜像站证书链。
- 不建议全局关证书验证（
composer config -g secure-http false），有安全风险 - 更稳妥的做法是更新 CA 包：
curl -sS https://getcomposer.org/installer | php重装 Composer，它会自带最新 CA - 实在不行再临时加参数绕过：
composer install --no-plugins --no-scripts -vvv，配合export COMPOSER_CAFILE=/path/to/cacert.pem
镜像源只是第一步，真正卡住的往往是插件或脚本阶段——比如 post-install-cmd 调用的 npm install 或私有 Git 仓库拉取，那些得单独处理，别指望换源一劳永逸。
