composer config -g repo.packagist 总不生效是因为必须同时满足三个硬性条件：键名严格为单数 repo.packagist（非 repos.packagist）、第二参数必须显式指定 type 值 “composer”、url 必须以 https 开头且末尾带斜杠，任一缺失均静默回退至 packagist.org。
composer config -g repo.packagist 命令为什么总不生效
不是命令没运行，是三个硬性条件漏掉一个就完全失效，且 Composer 2.x 会静默 fallback 到 packagist.org，不报错也不提示。
-
repo.packagist不能写成repos.packagist（多一个 s）或packagist.org；Composer 只认这个固定键名 - 中间的
composer是type值，不是可选参数，必须显式写出，不能省略或替换成https等字符串 -
url必须是 HTTPS，且末尾带斜杠：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出/p2//类路径，直接 404） - 必须加
-g，否则只改当前目录下的composer.json，换个项目就回退
验证是否写入成功：运行 composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错或只返回 URL 字符串（新版行为），都说明配置失败。
项目级配置怎么写才不破坏私有源
项目已有 repositories 字段时，手动编辑 composer.json 极易出错——漏引号、多逗号、误删已有源。正确做法是让 Composer 自动合并。
- 进项目根目录，执行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（注意：不加-g） - 如果
composer.json原本是"repositories": {}，命令会转为标准数组并追加packagist条目 - 如果原本是
"repositories": []，命令会向数组末尾插入新项，不覆盖原有私有仓库 - 千万别手写
"packagist": false或"packagist.org": false——这会禁用基础包索引，连php扩展校验都过不了 - 改完后必须运行
composer update --lock，确保composer.lock记录新源地址
composer update 还卡在 “Resolving dependencies”？镜像根本不管这事
镜像只加速元数据拉取和 ZIP 包下载，不加速依赖解析。这个阶段卡住，和网络无关，典型诱因有：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json里写了太宽的约束，比如"php": "^7.4 || ^8.0 || ^8.1"，让求解器暴力试遍所有组合 - 存在
"minimum-stability": "dev"，强制拉取不稳定分支，候选版本爆炸增长 -
composer.lock被删或没提交，update实际退化为全量重新解析 - 项目
composer.json中repositories指向了已下线私有源，Composer 逐个超时才 fallback
快速排查：进项目根目录，执行 composer config --list | grep repositories 看实际生效的是哪个源；再跑 composer validate --strict 确认 lock 文件合法；加 -vvv 查看日志里是否真在请求镜像域名（如 mirrors.aliyun.com）。
真正提速要配哪些参数
光换镜像只是第一步。composer update 生产环境必加这四个参数：
-
--no-dev：跳过require-dev（如phpunit），省掉 30–60% 时间 -
--prefer-dist：强制走 ZIP 包，避免git clone的 I/O 和网络开销 -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--no-scripts：跳过 post-install-cmd 等钩子脚本，尤其适合 CI 场景
额外建议：设 http-max-concurrent-downloads 为 10（不是已弃用的 parallel-downloads），命令是 composer config -g http-max-concurrent-downloads 10；CI 中还应缓存 ~/.composer/cache 目录。
别忽略优先级问题：项目级 repositories 会覆盖全局配置，宝塔或 CI 以 www 用户运行时，-g 写的是 root 的配置，得用 sudo -u www composer config -g ... 单独配。
