Composer缓存目录默认在Linux/macOS为~/.composer/cache，Windows为%APPDATA%\Composer\cache；改路径主因是磁盘空间、多用户共享、CI/CD隔离或SSD加速，推荐用COMPOSER_CACHE_DIR环境变量覆盖。
Composer缓存目录默认在哪，为什么需要改
Composer 默认把包下载、解压、安装过程中的临时文件和已下载的 zip 包存在 COMPOSER_HOME/cache 下。Linux/macOS 通常是 ~/.composer/cache，Windows 是 %APPDATA%\Composer\cache。
改路径常见原因：磁盘空间不足（比如系统盘小）、多用户共享环境需统一缓存、CI/CD 中避免污染本地缓存、或想把缓存挂载到 SSD 提速。
用 COMPOSER_CACHE_DIR 环境变量覆盖最可靠
这是 Composer 官方支持且优先级最高的方式，所有命令（composer install、composer update）都会立即生效，无需改配置文件或重装。
- Linux/macOS：在 shell 配置中添加
export COMPOSER_CACHE_DIR="/path/to/my/cache"，然后source ~/.bashrc或重启终端 - Windows（CMD）：
set COMPOSER_CACHE_DIR=D:\my-composer-cache - Windows（PowerShell）：
$env:COMPOSER_CACHE_DIR="D:\my-composer-cache" - Docker 场景：在
docker run加-e COMPOSER_CACHE_DIR=/cache，并-v $(pwd)/cache:/cache
注意：该变量只影响缓存（zip、dist、archived），不影响 vendor 目录或 COMPOSER_HOME（后者仍控制 auth.json、全局命令等位置）。
用 config 命令设全局 cache-dir 有局限性
composer config -g cache-dir /new/path 确实能写入 COMPOSER_HOME/config.json，但：
- 只对当前用户生效，不跨环境
- 如果同时设置了
COMPOSER_CACHE_DIR环境变量，它会被忽略（变量优先级更高） - 某些旧版 Composer（
- 路径必须是绝对路径，相对路径如
./cache会被当作相对于执行目录，容易出错
建议仅用于开发机临时调试，别依赖它做 CI 或部署。
验证是否生效和排查失败原因
运行 composer config --global cache-dir 查看配置值；再执行 composer global show -v，输出里会显示 Cache directory: 行，这才是真实生效路径。
常见失败点：
- 路径权限不足：目标目录不存在，或 Composer 进程无写权限（尤其 Linux 下用 root 装过全局包后切回普通用户）
- 路径含空格或特殊字符：Windows 上用双引号包裹变量值，但
COMPOSER_CACHE_DIR本身不支持引号，应避免空格路径 - 混用多个配置方式：比如同时设了环境变量又改了 config，结果以环境变量为准，但你却在查 config 输出，误以为没生效
缓存路径改完不会自动迁移旧数据，如果想复用历史包，得手动 cp -r ~/.composer/cache/* /new/path/（注意保持子目录结构）。
