换镜像无效的主因是repo.packagist拼写错误、url末尾缺斜杠或被项目级配置覆盖；必须严格满足键名单数、加-g参数、https且以/结尾三条件，否则静默回退至官方源。
换镜像本身不难，但配错就完全没效果——90% 的“换源后还是慢”问题，都出在 repo.packagist 拼错、URL 少斜杠、或被项目级配置静默覆盖。
composer config -g repo.packagist 总不生效？三个硬伤必须避开
这条命令不是“大概对就行”，漏掉任意一个细节都会静默 fallback 到官方源，且不报错：
-
repo.packagist不能写成repos.packagist（多一个 s 就彻底无效） - 必须带
-g参数，否则只改当前目录的composer.json，换项目就失效 - URL 必须是 HTTPS，且末尾必须有
/：比如https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会拼出/p2//类路径，直接 404）
验证是否成功：运行 composer config -g repo.packagist，输出应为完整 JSON，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null 或报错，说明根本没写进去。
项目级配置比全局更可靠，尤其适合 CI 和团队协作
全局配置写在 ~/.composer/config.json，但 CI 流水线用 runner 用户、宝塔后台用 www 用户、Docker 构建里甚至没有该路径——配置根本读不到。
推荐做法：进项目根目录，执行：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（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字段安全追加，不覆盖已有私有源 - 前提是原
repositories是对象（{}）或数组（[]）；如果是数组，命令会向末尾插入新项 - 改完必须删掉
vendor/和composer.lock，再执行composer install（不是update） - 千万别手动写
"packagist.org": false——这会彻底关掉官方源，一旦镜像临时不可用，composer install直接失败
换镜像后还卡在 “Resolving dependencies”？和网络无关
镜像只加速下载，不加速依赖解析。这个阶段卡住，典型原因有：
-
composer.json里写了太宽的 PHP 版本约束，比如"php": "^7.4 || ^8.0 || ^8.1"，让求解器暴力试遍所有组合 - 存在
"minimum-stability": "dev"，强制拉取不稳定分支，候选版本爆炸 -
composer.lock被删或没提交，install实际退化为update -
repositories数组里指向了已下线的私有源，Composer 逐个超时才 fallback
快速排查：执行 composer config --list | grep repositories 看实际生效的是哪个源；再跑 composer validate --strict 确认 lock 文件合法。
生产环境 install 四个必加参数
光换镜像只是第一步，真正提速还得靠这些参数：
-
--no-dev：跳过require-dev（如phpunit），省掉 30–60% 时间 -
--prefer-dist：强制走 ZIP 包，避免git clone的 I/O 和网络开销 -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--classmap-authoritative（或-a）：仅限部署用，告诉自动加载器“没在映射里 = 真没有”，彻底跳过文件扫描
CI/CD 推荐组合：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction --no-progress。注意：--classmap-authoritative 在本地开发中禁用，否则新增类会直接 Class not found。
