配了国内镜像仍慢，八成因只改元数据源未更新zip下载路径；需删除composer.lock和vendor后重装，确保dist.url指向镜像，且repo.packagist配置末尾带斜杠、https、键名正确。

配了国内镜像却还是慢，八成是只改了元数据源，没处理 GitHub zip 下载路径——composer install 卡在 Downloading https://codeload.github.com/ 就是典型症状。

为什么 composer config -g repo.packagist 不等于“全链路加速”

Composer 的下载分两层：元数据（包名、版本、依赖关系）走 packagist.org 或其镜像；实际 zip 包仍默认从 GitHub 原地址下载。阿里云、腾讯云等镜像只代理元数据，不托管 zip 文件。

• 现象：composer install -vvv 日志里出现 Downloading https://api.github.com/ 或 https://codeload.github.com/，且耗时超 10 秒
• 原因：镜像配置成功了，但 composer.lock 里记录的 dist.url 还是原始 GitHub 地址
• 关键点：换源后必须删掉 composer.lock 和 vendor/，再跑 composer install，否则旧 dist URL 会照用不误
• 注意：--repository 参数对已存在的 composer.lock 完全无效，它只影响元数据拉取环节

repo.packagist 配置必须带斜杠、HTTPS、且键名不能错

写错一个字符就会静默失效——命令不报错，但 composer config -g repo.packagist 输出为空或仍是 https://packagist.org。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 正确写法：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（末尾 / 不可省）
• 错误写法：composer config -g repos.packagist ...（多了一个 s）、https://mirrors.aliyun.com/composer（缺斜杠）、http://...（HTTP 被 Composer 2.0+ 拦截）
• 验证方式：运行 composer config -g repo.packagist，输出应为完整 URL 字符串或 JSON 对象，不含 "type": "composer" 的多半是旧版 Composer，也属正常
• 权限问题：如果提示 Could not open input file: composer，说明未加入系统 PATH；若报 Warning: putenv() has been disabled，需检查 php.ini 中 disable_functions 是否禁用了 putenv 或 proc_open

项目级配置别用命令覆盖 repositories 数组

执行 composer config repo.packagist ...（不加 -g）会**全量替换**当前项目的 repositories 字段，不是追加——已有私有 Git 源或 Satis 源会被清空。

• 安全做法：手动编辑 composer.json，在 "repositories" 数组开头或结尾添加一条：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
• 必须保留原有其他仓库条目，比如私有包源、本地 path 仓库，否则那些包将不可见
• 不要写 "packagist.org": false 在 repositories 内部——这是顶层字段，用于关闭官方源兜底，但一般不建议关，防镜像同步延迟导致 Package not found
• 改完后运行 composer update --lock，让 composer.lock 记录新源地址

真正卡住时，先看日志再动手

composer install -vvv | grep "Downloading\|Loading" 是唯一可信判断依据。光看终端卡住几秒没用，得确认请求域名是不是镜像站或 GitHub。

• 如果日志里全是 mirrors.aliyun.com，说明元数据层已生效，问题在 zip 下载环节
• 如果仍有 github.com，优先考虑 ghproxy.com 类反向代理，或临时加 composer config -g github-protocols https 强制走 HTTPS（避免 git 协议触发 SSH 问题）
• 遇到 Signature mismatch 错误，大概率是镜像同步延迟或本地缓存污染，先 composer clear-cache，再删 composer.lock 重装
• 旧项目升级时，留意是否残留 fxp/composer-asset-plugin——它不走 Composer 镜像配置，且已废弃，必须迁移到 npm-asset-packagist.org 或直接用 npm/yarn

最易被忽略的点：镜像只解决网络层瓶颈，不改变依赖解析逻辑。如果 composer update 卡在 Resolving dependencies，和镜像无关，得查 PHP 版本、config.platform.php 声明、或 lock 文件是否严重过期。