直接配阿里云镜像源即可显著提速，但需严格满足三个条件：键名必须为repo.packagist（单数）、type值必须显式写composer、URL须为HTTPS且末尾带/，任一不符均静默失效。
直接配阿里云镜像源就能显著提速，90% 的本地开发场景下，composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这一条命令就足够了。
全局配置为什么常失效却查不出原因
多数人执行完镜像配置命令没效果，并非网络问题，而是三个硬性条件全中招：
-
repo.packagist不能写成repos.packagist或repositories.packagist——多一个s就完全不生效，且无任何报错提示 - 必须显式声明
composer作为type值，漏掉它会导致 Composer fallback 到默认源（尤其在旧版中更隐蔽） - URL 必须是 HTTPS + 末尾带斜杠：
https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会返回 404）
验证是否成功：运行 composer config -g repo.packagist，输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的完整 JSON 对象。空、null 或报错都说明没写进去。
项目级配置更适合协作与 CI 流水线
你在本地配了全局镜像，但队友拉代码后行为不一致；CI 环境可能因用户权限或缓存导致失效。项目级配置写进 composer.json，所有环境行为统一：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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.aliyun.com/composer/（注意去掉-g） - 命令会自动在
composer.json顶层添加或合并"repositories"字段，key 必须是"packagist"，不能起别名如"aliyun" - 已有
"repositories"字段时，该命令是安全追加，不会覆盖私有源；手动编辑 JSON 容易格式出错（比如漏方括号、引号不全）
换源后首次 composer install 若报 hash 不匹配，删掉 vendor/ 和 composer.lock 重来即可。
多个镜像源不是“自动选最快的”，顺序决定一切
Composer 不支持轮询或故障转移。它只按 repositories 数组顺序查找，**仅当上一个源明确返回 404（包不存在）时，才尝试下一个**；若超时、500 或 DNS 失败，就会卡住并报错，根本不会回退。
- 典型安全写法（放在项目
composer.json中）：{ "repositories": [ {"type":"composer","url":"https://mirrors.aliyun.com/composer/"}, {"type":"composer","url":"https://packagist.phpcomposer.com/"}, {"type":"composer","url":"https://packagist.org/","packagist": false} ] } - 前两个是国内镜像，按响应速度排序（阿里云通常比腾讯云快）
- 第三项显式启用
packagist.org，但设"packagist": false表示不把它当作默认源，只作兜底 -
注意：
packagist.org必须显式列出才能生效；只靠默认行为不可控
SDK 接入失败？先确认是不是镜像没生效，再查包名和 PHP 环境
遇到 composer require 报 “could not find package”，别急着换源或重装 Composer：
- 先跑
composer config -g repo.packagist，确认镜像已生效；否则你连国内源都没走，还在等 packagist.org 超时 - 去官方文档复制
composer require xxx/xxx示例，别手敲——aliyuncs/oss-sdk-php和alibabacloud/oss是两回事 - 检查 PHP 版本和扩展：
php -v、php -m | grep -E 'curl|json|openssl'，几乎所有 SDK 都强依赖这三项 - 如果 SDK 分核心包 + 服务包（如
alibabacloud/client+alibabacloud/ecs），只装核心包是不够的
真正容易被忽略的是：镜像只是加速下载，它不解决包名错误、PHP 版本不兼容、扩展缺失这三类根本问题。配置再快，填错包名也白搭。
