直接结论：无需额外工具，composer 自带的 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 命令即可完成镜像切换，必须严格满足三要素：键名 repo.packagist（单数小写）、type 值为 composer、url 为以 / 结尾的 https 地址，缺一则静默失效。
直接换源就能解决，但90%的人配不成功——不是网络被墙，是命令写错了三个关键点。
composer config -g repo.packagist 命令必须写对三要素
这条命令不是“大概对就行”，漏掉任意一个都会静默失效，且不报错：
-
-g不能省：缺了就只改当前项目composer.json，换目录就失效 -
repo.packagist是唯一合法键名（注意是repo单数，不是repos；也不能写成packagist.org） -
composer是type值，不是可选参数——省略后 Composer 2.0+ 会 fallback 到官方源 -
https://mirrors.aliyun.com/composer/必须用 HTTPS，且末尾斜杠/不能少（少斜杠会拼出/composerpackages.json导致 404）
正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
验证是否生效：composer config -g repo.packagist，应输出类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空、null 或报错，说明没写对。
项目级配置比全局更可靠，尤其适合团队和 CI
全局看着省事，但实际容易踩坑：
- 某些项目在
composer.json里写了"packagist.org": false，会直接屏蔽全局镜像 - CI 流水线常以
www或runner用户运行，而-g配的是当前登录用户的配置，权限不一致就失效 - 新人拉代码后行为不一致——全局配置无法被 Git 跟踪
推荐做法：进项目根目录，运行 composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉 -g）。它会自动在 composer.json 顶层写入 "repositories" 字段，key 固定为 "packagist"，不会覆盖已有私有源——前提是原来 repositories 是对象结构（不是数组）。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
如果项目已存在 "repositories" 数组，别手动覆盖，用命令追加，否则可能误删私有包源。
换源后仍卡在 “Resolving dependencies”？和镜像无关
镜像只加速下载，不解决依赖解析慢的问题。如果你发现 composer update 卡在 Resolving dependencies 几十秒甚至几分钟，基本可以确定是本地环境或 composer.json 写法导致的：
- PHP 版本约束太宽（如
"php": "^7.4 || ^8.0"） - 大量未锁定版本的
dev包 -
require-dev里塞了太多工具链
这类问题换任何镜像都无效，得从约束收紧、dev 包拆分、锁版本入手。
阿里云镜像仍是当前最稳选择，但要注意路径细节
https://mirrors.aliyun.com/composer/ 目前（2026年中）同步最及时、HTTPS + HTTP/2 支持完整、域名稳定。其他可选源：
- 腾讯云：
https://mirrors.cloud.tencent.com/composer/ - 华为云：
https://mirrors.huaweicloud.com/repository/php/composer/（注意路径含/repository/php/，不是/composer/）
别再用已停更多年的 packagist.phpcomposer.com，现在访问直接 404。
最后提醒一句：换源后首次 composer install 若报 hash 校验失败，删掉 vendor 和 composer.lock 重来即可；临时验证镜像可用性，可用 composer install -vvv --repository-url=xxx，加上 -vvv 才能看到真实请求地址。
