必须显式配置cache-files-dir,仅设cache-dir无效;路径须为绝对路径且含/files子目录,COMPOSER_CACHE_DIR环境变量优先级最高并会完全覆盖其他配置。

必须显式配置 cache-files-dir,仅设 cache-dir 无效;路径需绝对、含 files 子目录,且环境变量 COMPOSER_CACHE_DIR 会直接覆盖它。
为什么 cache-dir 配了也没用?
Composer 的下载缓存(.zip 包)实际存在 cache-files-dir 指向的路径下,不是 cache-dir 根目录。后者只管 repo 元数据和 archived 包,files/ 子目录才是 dist 下载落盘位置。只运行 composer config --global cache-dir /path/to/cache,composer install --prefer-dist 仍会把 zip 写进默认的 ~/.cache/composer/files/。
-
cache-files-dir必须显式设置,不能靠cache-dir推导 - 值必须是绝对路径,且结尾含
/files(如/d/composer-cache/files) - 该路径需手动创建,并确保当前用户有读写权限
怎么正确设置 cache-files-dir?
推荐用命令一次性写对:
composer config --global cache-files-dir "/d/composer-cache/files"
注意:
- Windows 上避免用
%APPDATA%—— PowerShell 不展开,CMD 可能出错;建议先查清真实路径再填绝对路径 - Linux/macOS/WSL 中,路径如
/mnt/d/composer-cache/files,确认/mnt/d已挂载且可写 - 设完立即验证:
composer config --global cache-files-dir应输出完整路径,非空、非null
环境变量 COMPOSER_CACHE_DIR 优先级最高
只要这个变量存在,Composer 就完全忽略 cache-dir 和 cache-files-dir 配置。CI 或 Docker 中最容易踩坑:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 检查是否被设:Bash 执行
echo $COMPOSER_CACHE_DIR,PowerShell 执行$env:COMPOSER_CACHE_DIR - 若非空,且值不是你期望的路径,要么 unset 它,要么直接让它指向正确位置
- 临时生效(Bash):
COMPOSER_CACHE_DIR="/d/composer-cache" composer install - 临时生效(PowerShell):
$env:COMPOSER_CACHE_DIR="D:\composer-cache"; composer install
验证是否真命中缓存文件
改完必须清旧缓存再试:
composer clear-cache
然后运行:
composer install --no-autoloader --no-scripts --prefer-dist -vvv 2>&1 | grep "Downloading.*\.zip"
观察输出中下载 URL 的域名是否匹配镜像源,同时检查 cache-files-dir 路径下是否生成了类似 monolog/monolog/2.10.0.0/monolog-monolog-6a8c4b5.zip 的结构。没看到 zip 文件,说明路径没生效或 Composer 拒绝复用(常见于 lock 文件变更、PHP 版本不一致)。
最常被忽略的是:路径写了但没创建目录,或权限不对——Composer 不报错,只默默 fallback 到默认位置。

















