配中文镜像不是“锦上添花”，而是解决 composer install 卡在 github 下载的刚需；config -g repo.packagist 失效主因是键名错误、type 缺失或 url 格式不对；项目级配置更可靠，但需注意 repositories 格式；换源后仍卡在 downloading 是因 lock 文件固化原始 dist 地址，需删 vendor 和 lock 重装。
配中文镜像不是“锦上添花”，而是解决 composer install 卡在 Downloading https://codeload.github.com/ 的刚需——不配，90% 的国内 PHP 开发者会遭遇超时、重试、甚至 could not find package 报错。
为什么 composer config -g repo.packagist 总是不生效
这条命令静默失败的概率远高于成功，根本原因就三点：
-
repo.packagist键名不能写成repos.packagist（多一个 s）、packagist（少前缀）或mirror（Composer 不识别） - 中间的
composer是type值，必须显式写出；漏掉它，Composer 2.0+ 会直接 fallback 到官方源，不报错也不提示 - URL 必须以
https://开头，且末尾带/，例如https://mirrors.aliyun.com/composer/；少斜杠会导致请求路径拼成/composerpackages.json，404 后静默回退
验证是否写对：运行 composer config -g repo.packagist，输出必须是完整 JSON，如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或只返回字符串，说明没生效。
项目级配置比全局更可靠，但别覆盖已有私有源
全局配置在宝塔、CI、Docker 构建中大概率失效——因为它们用的是 www、runner 或无家目录用户，根本读不到你 root 下的 ~/.composer/config.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 字段，仅新增 "packagist" 条目。但它有个前提：
- 若原 "repositories": {}（空对象），它会转为标准数组并追加
- 若原 "repositories": []（空数组），命令会失败，需先手动改成对象格式
千万别手写 "packagist.org": false——这会彻底关掉基础包校验，导致 php、ext-json 等平台约束无法验证，后续安装直接报错。
换源后仍卡在 Downloading？问题大概率不在镜像本身
阿里云、腾讯云等镜像站只代理元数据（packages.json），不托管 zip 包。所以即使 repo.packagist 配对了，composer install -vvv 日志里仍可能出现：
Downloading https://api.github.com/Downloading https://codeload.github.com/
这是因为 composer.lock 文件里已固化了原始 GitHub dist URL。此时：
- 删掉
vendor/和composer.lock，再跑composer install，才能让新镜像真正参与下载流程 - 临时加
--repository参数无效——它只影响元数据获取，对 lock 文件里的 dist 地址完全无感 - 企业级解法是部署
satis或用ghproxy.com类反向代理，把 GitHub zip 缓存到本地；个人开发更推荐直接加github-protocols强制走 HTTPS：composer config -g github-protocols https
最易被忽略的一点：镜像只加速元数据加载和 zip 下载，对 Resolving dependencies 阶段毫无作用。如果 composer update 卡几十秒，别折腾镜像，先收紧 require-dev 版本约束、删掉未锁定的 dev- 分支依赖——那才是真瓶颈。
