Composer本地缓存是自动写入的产物，仅files/子目录下的zip包支持离线复用；需配置cache-files-dir、清空旧cache-dir、执行--prefer-dist下载，并验证monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip结构。
Composer本地缓存不是“配出来”的，而是你每次运行 composer install 或 composer update 时自动写入的产物；真正能离线复用、CI 持久化、打包带走的，只有 files/ 子目录下的 zip 包——其他路径（如 repo/、vcs/）断网即失效。
为什么改了 cache-dir 还没缓存？
常见错觉是设了 cache-dir 就万事大吉。实际它只是个混合目录，里面混着 repo/（元数据）、archived/（解压后归档）、files/（原始 dist zip）。但只有 files/ 下的 vendor/package/version.zip 才能在离线时被 --prefer-dist 直接读取。
-
cache-dir被设成/dev/null或只读路径 → 缓存写不进去 - 项目里写了
"config": { "cache-dir": false }→ 直接禁用缓存 - CI 脚本漏了挂载持久卷，或根本没设
COMPOSER_CACHE_DIR→ 每次构建都是空缓存 - PHP 进程用户（如
www-data）对~/.composer/cache无写权限 → 日志里静默失败
cache-files-dir 是离线场景唯一该配的路径
这个配置项专为离线设计，只控制 files/ 子目录位置，不干扰 repo/ 或 archived/。一旦设好，composer install --prefer-dist 就会把所有下载的 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（避免和cache-files-dir冲突） - 设新路径：
composer config --global cache-files-dir /path/to/offline-cache - 触发下载：
composer install --no-autoloader --no-scripts --prefer-dist - 验证是否生效：检查目标路径下是否有类似
monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip的结构
镜像源配错一个字符就静默 fallback 到 packagist.org
关键不是 URL 对不对，而是三要素缺一不可：
- 键名必须是
repo.packagist（单数，不能是repos.packagist或packagist.org） -
type值必须显式写composer（不是可选参数，也不是注释） - URL 必须 HTTPS 开头 + 末尾带
/（例如https://mirrors.aliyun.com/composer/✅，少斜杠就 404）
验证命令：composer config -g repo.packagist，输出必须是完整 JSON 对象，形如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。空、null、报错、或只返回字符串，都说明没生效。
真正容易被忽略的是：缓存目录本身不是瓶颈，而 files/ 是否被精准挂载、是否在 CI 中用 hashFiles('**/composer.lock') 作 key、以及镜像配置是否通过 composer config -g repo.packagist 确认过输出——这三点漏掉任一，缓存就等于没用。
