答案是必须验证配置生效且镜像源支持依赖包：优先检查项目级repositories字段是否覆盖全局配置，再用composer config -g repo.packagist和composer diagnose确认实际生效源，最后通过composer install -vvv观察请求url验证。
直接换镜像源就能解决大部分 Composer install 下载慢或失败的问题，但必须确保配置生效且镜像源本身支持所有依赖包（尤其是私有包）。
确认当前全局源是否被污染
很多人执行 composer config -g repo.packagist 看到的是 https://packagist.org，就以为没问题——其实可能已被本地项目配置覆盖。真正起作用的是优先级更高的配置层级：
- 项目根目录下的
composer.json中repositories字段（最高优先级） - 当前用户家目录的
composer.json（~/.composer/config.json或~/composer/config.json） - 系统级配置（极少用，不推荐）
排查时运行：composer config --list --global 和 composer config --list（不带 --global）对比输出，重点看 repositories 和 repo.packagist 项。
使用国内主流镜像源（如阿里云、腾讯云）的正确写法
阿里云和腾讯云的 Packagist 镜像只代理公共包，不支持私有仓库协议（如 vcs、package 类型），所以不能简单替换为 type: composer 的单一源。必须保留默认源结构，仅替换主 registry 地址：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意三点：
- 末尾必须带
/，否则部分版本会解析失败 - 命令中
composer是 type，不是 URL；不能写成composer config -g repos.packagist https://... - 如果项目里已有
repositories，这条全局配置会被忽略——得进项目里删掉或改写
同时使用私有源 + 公共镜像源的配置方式
私有包（比如公司内部的 mycorp/utils）通常托管在 GitLab 或私有 Satis 服务上，这类源和公共镜像不兼容，必须共存。正确做法是显式声明多个源，并把私有源放在前面：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
{
"repositories": [
{
"type": "composer",
"url": "https://packages.mycorp.com"
},
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
],
"config": {
"secure-http": false
}
}
关键细节：
- 顺序很重要：Composer 按列表顺序查找包，私有包名不会出现在公共镜像中，所以私有源必须置顶
-
secure-http: false仅当私有源用 HTTP（非 HTTPS）时才需要，生产环境应避免 - 若私有源是
vcs类型（如 GitLab 仓库地址），它只能用于指定包，无法替代整个 Packagist，此时仍需保留第二个镜像源
验证配置是否真正生效
别只信 composer config 输出——实际安装时才会触发源解析。最可靠的验证方式是加 -vvv 参数观察请求日志：
composer install -vvv 2>&1 | grep "Downloading http"
你会看到类似：
Downloading https://mirrors.aliyun.com/composer/p2/mycorp/utils.json Downloading https://packages.mycorp.com/p2/mycorp/internal-tool.json
如果仍出现 packagist.org 或超时重试，说明某层配置没生效，回退检查 composer.json 是否被 require 或脚本覆盖，或是否存在 COMPOSER_HOME 环境变量指向了错误路径。
私有源配置最容易被忽略的点是：团队协作时，有人把 repositories 写进了 composer.json，却忘了提交，或者用了相对路径的本地源（type: path）导致 CI 失败。
