配了国内镜像仍慢，八成因只改元数据源未更新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）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “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 文件是否严重过期。
