单纯改 Composer 中文镜像源对构建时长降低30%–70%，但常因配置错误（如repo.packagist拼写错误、URL缺斜杠、漏-g参数）导致未生效；需验证config输出为完整JSON，Docker中须显式配置；卡在“Resolving dependencies”与镜像无关，属依赖解析问题；加速构建还需--no-dev、--prefer-dist、--optimize-autoloader、--classmap-authoritative四参数组合。
单纯改 Composer 中文镜像源，对 composer install 构建时长的降低幅度通常在 30%–70%，但前提是配置正确、缓存有效、且不卡在依赖解析阶段——多数人实际只看到 0% 改善，因为根本没生效。
为什么composer config -g repo.packagist经常白配
命令执行成功 ≠ 镜像真正启用。三个硬伤一错全废：
-
repo.packagist写成repos.packagist（多一个 s）：Composer 完全忽略，不报错也不提示 - URL 少结尾斜杠：
https://mirrors.aliyun.com/composer→ 拼出/p2//类路径，404 后 fallback 到官方源 - 漏掉
-g或 type 值：composer config repo.packagist composer ...只改当前目录composer.json，CI 容器里根本读不到
验证必须跑 composer config -g repo.packagist，输出得是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、或仍显示 packagist.org，说明没写进去。
Docker 构建中镜像源配置必须显式写进 Dockerfile
宿主机配了全局镜像，对容器内 composer install 完全无效——构建阶段是全新 root 用户、空 ~/.composer 目录。
立即学习“PHP免费学习笔记（深入）”；
- 推荐做法：在
RUN composer install前加一行RUN composer config --global repo.packagist composer https://mirrors.aliyun.com/composer/ - 更稳妥：用
COPY把预生成的config.json放进/root/.composer/，避免命令执行失败的风险 - 最简方案：直接
RUN composer install --repository=https://mirrors.aliyun.com/composer/，参数直传，不依赖任何配置
注意：--repository 参数优先级高于全局配置，适合 CI 场景快速兜底。
composer install 卡在 “Resolving dependencies” 不是镜像问题
镜像只加速下载（Downloading），不加速依赖求解。这个阶段卡住，和网络无关，典型诱因有：
-
"php": ">=7.4"这类宽泛约束，让 Composer 暴力穷举所有兼容版本组合 -
"minimum-stability": "dev"开启后，候选包数量指数级增长 - 删过
composer.lock又执行composer install，实际退化为update - 项目
composer.json中repositories字段指向已失效私有源，逐个超时才 fallback
排查命令：composer config --list | grep repositories 看真实生效源；composer validate --strict 检查 lock 文件合法性。
真正影响构建时长的四个关键参数
光换镜像只是起点，生产构建必须加这四个参数：
-
--no-dev：跳过require-dev包（如phpunit），省掉 30–60% 时间 -
--prefer-dist：强制走 ZIP 包，避免git clone的 I/O 和网络开销（实测比 source 快 2–5 倍） -
--optimize-autoloader（或-o）：生成静态类映射，PHP 7.4+ 下可进 opcache -
--classmap-authoritative（或-a）：部署专用，跳过文件扫描，但本地开发禁用（否则新增类直接Class not found）
CI 推荐组合：composer install --no-dev --prefer-dist --optimize-autoloader --classmap-authoritative --no-interaction。别忘了在 Dockerfile 中把 COPY composer.json composer.lock ./ 放在 RUN composer install 之前——否则任意代码改动都会让缓存失效，镜像再快也白搭。
