直接执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/即可全局生效，该命令写入用户级配置文件，末尾斜杠不可省略，键名repo.packagist不能拼错，执行后无需改文件、重启终端或清缓存。
直接执行命令就能全局生效
不用改文件、不用重启终端，一条命令立刻切换镜像源。很多人卡在“为什么还是慢”，其实是命令写错了——repo.packagist 不能多写一个 s 变成 repos.packagist，也不能漏掉中间的 composer 类型声明。
运行：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否成功：
composer config -g repo.packagist
输出应为类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 或直接是 URL 字符串。如果返回空、null 或报错，说明没写对。
-
https://mirrors.aliyun.com/composer/末尾必须带斜杠，否则部分版本会 fallback 到默认源 - 旧版 Composer（如 1.x）不支持 HTTPS 镜像，会卡在
Loading composer repositories...—— 执行composer self-update升级到 2.5+ 再试 - 如果提示
Could not open input file: composer，说明composer不在$PATH，先查安装路径（比如/usr/local/bin/composer），再补环境变量
临时换源只对当次命令有效
适合 CI 脚本、测试单个包、或不想污染全局配置的场景。参数名必须是 --repository，不是 --repository-url 或 --mirror，后者会被静默忽略。
示例：
composer create-project laravel/laravel demo --repository=https://mirrors.tencent.com/composer/
加 -vvv 可确认真实请求地址：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer update -vvv --repository=https://mirrors.huaweicloud.com/composer/
注意：
- 临时参数优先级最高，但会完全覆盖项目里已有的
repositories配置 —— 如果项目用了私有 Git 包，这次命令会找不到它们 - 个别包（如 GitHub 直链、私有仓库）不受镜像影响，仍走原始地址，这是正常行为，不是镜像失效
- 公司内网若拦截 HTTPS，可临时降级用
http://mirrors.aliyun.com/composer/（仅限可信环境）
换源后还卡在 Resolving dependencies？那和镜像无关
镜像只加速下载阶段（Downloading），不干预依赖解析逻辑。如果你发现 composer update 卡在 Resolving dependencies 几十秒以上，基本可以排除镜像问题。
常见真实原因：
-
composer.json里约束太宽（比如"monolog/monolog": "*"），导致 Composer 要遍历大量版本做兼容检查 - 本地 PHP 版本或扩展缺失（如
mbstring、zlib），导致某些包的 autoload 或压缩解包失败 - 缓存损坏：先运行
composer clear-cache，再重试 - 遇到
Failed to decode response: zlib_decode(): data error，大概率是 PHP 的zlib扩展异常，检查php.ini中zlib.output_compression是否关闭
项目级配置更适合协作和 CI
全局配置省事，但容易在团队混用时引发 hash 不一致、依赖解析差异等问题。项目级配置写进 composer.json，拉代码即生效，更可控。
进项目根目录，运行：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/
该命令会自动在 composer.json 顶层添加 "repositories" 字段，key 必须是 "packagist"，不能自定义为 "aliyun" 等别名。
注意：
- 如果项目已有
repositories，别手动编辑覆盖 —— 用命令追加，避免误删私有源 - 换源后首次
composer install若报 hash 校验失败，删掉vendor/和composer.lock重来即可 - Debian 系统上，确保
php-zip、php-xml、php-mbstring已安装，否则部分包无法解压或解析
repositories 配置层级之间的覆盖关系——这些细节不出错，镜像才能真正起效。 
