Composer导出慢主因是cache-files-dir未配置或未命中，必须显式设置并验证；导出需用--no-dev --prefer-dist --no-autoloader --no-scripts --no-interaction组合，且镜像源三要素（键名、type、URL末尾/）缺一不可。
Composer 导出（composer install --no-dev --prefer-dist）慢，不是因为没缓存，而是缓存没被正确命中或没被导出场景真正复用。 默认的 cache-dir 下混着元数据、VCS、解压归档，但只有 files/ 子目录里的 ZIP 包能离线复用——而导出阶段恰恰只依赖它。
确认 cache-files-dir 是否生效
很多人设了 cache-dir 就以为缓存到位了，其实它只是个“总目录”，里面包含 repo/、vcs/、archived/ 等多个子模块，只有 files/ 下的 ZIP 才能在断网或 CI 复用。必须单独配置 cache-files-dir：
- 先清掉旧配置：
composer config --global --unset cache-dir（避免冲突） - 指定纯 ZIP 缓存路径：
composer config --global cache-files-dir /opt/composer-cache/files - 验证是否写入：
ls -l /opt/composer-cache/files/monolog/monolog/，应能看到类似2.10.0.0/monolog-monolog-6a8c4b5.zip的结构 - 若路径下为空，说明下载时没走
--prefer-dist，或镜像源配错导致 fallback 到 packagist.org
导出命令必须带 --prefer-dist 且禁用 autoload
composer install 默认可能走 git clone（尤其私有包或 dev- 版本），跳过 ZIP 缓存；而 --prefer-dist 强制走压缩包下载，才能命中 cache-files-dir。同时，导出环境不需要自动加载器生成：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 正确组合：
composer install --no-dev --prefer-dist --no-autoloader --no-scripts --no-interaction - 漏掉
--no-autoloader会导致生成vendor/autoload.php和 classmap，浪费 IO 且无意义 - 漏掉
--no-scripts可能触发 post-install-cmd（如 Laravel 的php artisan optimize:clear），拖慢导出节奏
CI 中挂载缓存要精准到 files/ 目录
GitHub Actions、GitLab CI 等常挂载整个 ~/.composer/cache，但实际只需 files/。挂错路径等于白搭：
- GitHub Actions 示例：
actions/cache@v4的path应设为~/.composer/cache/files，key 建议含composer.lock-hash或PHP_VERSION - Docker 构建中，不要只
VOLUME ["/root/.composer/cache"]，而应在构建前COPY已预热的files/目录 - 若用
COMPOSER_CACHE_DIR环境变量，它只影响cache-dir，不控制cache-files-dir——后者必须用composer config显式设置
镜像源配错一个字符，缓存就完全失效
镜像配置不是“差不多就行”，三要素缺一不可，否则静默回退到 packagist.org，所有缓存策略归零：
- 键名必须是
repo.packagist（单数，不是repos.packagist） -
type字段必须显式写"type": "composer"（旧版 Composer 1.x 需用repos.packagist+ JSON 字符串） - URL 必须 HTTPS 开头 + 末尾带
/（https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌） - 验证命令：
composer config -g repo.packagist输出必须是完整 JSON 对象，不能是字符串或空
真正容易被忽略的是：缓存本身没问题，但 files/ 目录没被挂载、没被复制、或根本没生成 ZIP —— 这些比调参数更决定导出成败。
