--no-dev无法解决镜像源配置错误导致的网络卡顿，必须正确配置镜像（如url拼写、type字段、末尾斜杠）并配合--prefer-dist等参数才能真正提速。

镜像源没配对，--no-dev 也救不了卡顿

镜像源配置错误时，--no-dev 能跳过 dev 包，但解决不了网络层卡死。常见错误包括：repo.packagist 拼错成 repos.packagist、URL 缺末尾斜杠、漏写 "type": "composer" 字段。验证方式很简单：composer config -g repo.packagist 输出必须是完整 JSON，否则就等于没生效。

--prefer-dist 在镜像未命中时会 fallback 到 source

国内镜像（如阿里云）只缓存 .zip/.tar.gz dist 包，不缓存 git source。一旦某个包没被镜像收录，--prefer-dist 就会失败并自动退回到慢速 git clone——此时 --no-dev 虽然仍生效，但安装耗时可能从几秒飙升到数分钟。尤其私有包只提供 Git 地址时，--prefer-dist 直接报错：Could not find a matching version of package xxx。

--no-dev 和镜像配合才能真正提速

--no-dev 本身不依赖镜像，但它和镜像协同才有实际意义：

Discussion Composer

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

下载

• 镜像加速下载，--no-dev 减少需下载的包数量（跳过 phpunit、phpstan 等整棵 dev 依赖树）
• 两者叠加后，依赖解析+下载+解压总耗时可从 3 分钟以上压到 5 秒内
• 若只换镜像不加 --no-dev，仍会拉下大量 dev 包，磁盘占用翻倍、autoload 扫描路径变多、安全面扩大

CI/CD 中必须显式声明镜像 + 参数组合

很多 CI 流水线在 Docker 构建阶段执行 composer install --no-dev，却忘了镜像配置是否全局生效。问题在于：composer config -g 写入的是用户级配置，在无状态容器中很可能丢失。正确做法是：

• 构建前显式设置：composer config -g repo.packagist '{"type":"composer","url":"https://mirrors.aliyun.com/composer/"}'
• 立即验证：composer config -g repo.packagist 输出非空 JSON
• 再执行完整命令：composer install --no-dev --prefer-dist --optimize-autoloader --no-autoloader --no-scripts

漏掉任何一环，比如没验证镜像是否真生效，或没关掉 --no-autoloader 导致 autoload 生成阻塞构建，都会让 --no-dev 的收益归零。