阿里云composer镜像源配置需严格满足三条件：repo.packagist（无s）、type为composer、url为https且末尾带斜杠；全局配置易因任一条件缺失而静默失效，验证需输出完整json对象；项目级配置更适协作与ci，临时使用--repository-url参数可覆盖所有配置但仅限当次命令。
直接配阿里云镜像源就能显著提速，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，所有环境行为统一：
- 进项目根目录，运行
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 重来即可。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
临时指定镜像只对当次命令有效
不想改任何配置，又想快速验证某个镜像是否可用？用 --repository-url 参数：
composer install -vvv --repository-url=https://mirrors.huaweicloud.com/repository/php/composer/- 加上
-vvv才能看到真实请求地址，否则你根本不知道连的是谁 - 这个参数优先级最高，会覆盖全局和项目配置，但仅限
install、update等主命令；require后加该参数无效
注意：腾讯云和华为云地址路径不同，华为云必须带 /repository/php/ 路径段，腾讯云末尾也要斜杠；已停更的 packagist.phpcomposer.com 现在访问直接 404。
换源后还卡在 Resolving dependencies？那和镜像无关
镜像只加速包下载（Downloading 阶段），不解决依赖解析慢的问题。如果 composer update 卡在 Resolving dependencies 几十秒以上，基本可排除镜像原因：
- 检查
composer.json中 PHP 版本约束是否太宽，例如"php": "^7.4 || ^8.0"会让解析器穷举组合 - 大量未锁定版本的
dev-包或require-dev工具链会显著拖慢解析速度 - Composer 2.2+ 默认启用 fallback：镜像返回 404/503 时会自动切回
packagist.org查一次，所以偶尔慢也可能是 fallback 触发了
真正影响速度的，往往不是“连不上”，而是“算不出”。这时候该优化 composer.json，而不是换镜像。
