应运行composer diag查看cache directory:行输出的路径，该路径才是当前实际生效的缓存根目录；composer config --global cache-dir仅显示配置值，可能被环境变量覆盖或未生效。
怎么确认当前生效的缓存路径
别信 composer config --global cache-dir 的输出值——它可能被环境变量覆盖，也可能只是配置了但没生效。真正有效的路径，得看 composer diag 输出的 Cache directory: 行。
运行命令后注意三点：
- 如果输出路径是
/root/.composer/cache但你在普通用户下执行，说明当前用户没设COMPOSER_HOME，Composer fallback 到 root 目录（常见于 Docker 容器里用 root 启动） - 路径末尾带
repo/或files/？那是子目录，Cache directory:显示的是主缓存根目录 - 若显示
Cache directory: /dev/null或空行，说明缓存被禁用（比如cache-read-only为 true 且无读取权限）
改缓存路径时最容易踩的三个坑
改完不生效，90% 是栽在这三处：
-
cache-dir必须是绝对路径，~不会被解析，写/home/alex/.composer/cache，别写~/.composer/cache - 目录必须存在且当前用户有读写权限：先
mkdir -p /data/composer-cache，再chown $USER:$USER /data/composer-cache - 环境变量
COMPOSER_CACHE_DIR优先级最高，哪怕你刚用config --global改了，只要这个变量还设着，就以它为准；CI 脚本里尤其容易漏掉检查echo $COMPOSER_CACHE_DIR
离线安装只认 cache-files-dir，不是 cache-dir
composer install --prefer-dist 断网能跑通，唯一依赖的是 cache-files-dir 下的 ZIP 包。它和 cache-dir 是两套路径逻辑：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
cache-dir是总根目录，下面有files/、repo/、vcs/等子目录 -
cache-files-dir是专门存 ZIP 包的路径，默认等于$cache-dir/files，但可以单独配置 - 离线场景必须显式设置：
composer config --global --unset cache-dir（避免冲突），再composer config --global cache-files-dir /opt/offline-cache/files - 验证是否写入成功：进该目录看有没有类似
monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip的嵌套结构
镜像源配错一个字符，缓存就白设
改完镜像后 composer install 还卡在 Loading composer repositories？大概率是镜像地址写错了，Composer 静默 fallback 到 packagist.org，而你的缓存里没有它的元数据。
正确操作顺序是：
- 全局设置镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意结尾斜杠不能少） - 立刻清旧缓存：
composer clear-cache（否则仍读旧repo/下的 packages.json） - 验证是否生效：
composer install -vvv 2>&1 | grep "Downloading https"，应看到域名是mirrors.aliyun.com，不是repo.packagist.org - 如果还卡住，用
curl -I https://mirrors.aliyun.com/composer/packages.json确认网络层是否通，再查 PHP cURL 是否启用了 SSL 支持
真正难排查的是缓存路径与镜像源的耦合关系：缓存目录写对了、镜像也设对了，但没清缓存，或者清了却没重跑 install —— 此时 Composer 一边读着旧 repo 数据，一边试图从新镜像下载包，行为完全不可预测。
