composer install --no-dev --prefer-dist --optimize-autoloader 重度依赖已有缓存，导出慢主因是缓存未命中：cache-files-dir未配置或不可写、镜像URL末尾缺“/”导致回退官方源、或误用--prefer-source；必须配cache-files-dir、确保镜像URL完整且含斜杠、并验证composer diagnose无写入错误。
Composer 导出（composer install --no-dev --prefer-dist --optimize-autoloader）本身不“生成”缓存，而是**重度依赖已有缓存**；导出慢，90% 是因为缓存没命中、镜像没配对、或 --prefer-dist 被悄悄绕过。
为什么 composer install 导出时仍要下载 ZIP？
导出阶段仍触发下载，说明缓存未被复用。根本原因不是“没缓存”，而是缓存路径或结构不满足离线复用条件：
-
cache-dir被设为只读、/dev/null或权限不足 → 缓存写入失败，后续也读不到 - 项目中
composer.json含"config": { "cache-dir": false }→ 全局配置被覆盖，静默禁用 - 没配
cache-files-dir，而默认cache-dir下的files/子目录又恰好被 CI 清理了 → 只剩元数据，无 ZIP 包可用 - 用了
--prefer-source或依赖里声明了"source"类型 → 强制走 Git 克隆，完全跳过缓存 ZIP
cache-files-dir 是导出加速唯一值得配的缓存项
它专为离线/导出场景设计：只控制 files/ 目录位置，确保所有 .zip 包被集中、稳定写入，方便打包带走或挂载复用。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 先清旧冲突：
composer config --global --unset cache-dir - 设新路径（推荐绝对路径，避免 ~ 展开问题）：
composer config --global cache-files-dir /opt/composer-cache-files - 触发一次完整下载：
composer install --no-dev --prefer-dist --optimize-autoloader - 验证是否落盘：
ls /opt/composer-cache-files/monolog/monolog/2.10.0.0/应见类似monolog-monolog-6a8c4b5.zip的文件
导出命令必须带 --prefer-dist 且镜像 URL 末尾带 /
缺一不可。不加 --prefer-dist，Composer 默认可能 fallback 到 --prefer-source；镜像 URL 少斜杠（如 https://mirrors.aliyun.com/composer），会 404 并静默回退到 packagist.org，导致导出时重走慢链路。
- 确认镜像生效：
composer config -g repo.packagist输出必须是完整 JSON：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 导出命令示例（CI 中最稳组合）：
composer install --no-dev --prefer-dist --optimize-autoloader --no-interaction --no-scripts - 若仍卡在 downloading，立刻检查：
composer diagnose是否报 “The configured cache directory is not writable”
真正卡住导出的，从来不是 Composer 本身，而是 files/ 目录没被精准挂载、镜像 URL 少了个 /、或者 --prefer-dist 被某处配置意外压制——这些地方不报错，只默默变慢。
