直接设置 COMPOSER_CACHE_DIR 环境变量即可指定 Composer 缓存目录，无需改配置或重装；不同系统设置方式不同但原理一致，需确保路径存在且可写，其优先级高于全局配置但低于 --cache-dir 参数。

直接设置 COMPOSER_CACHE_DIR 环境变量即可让 Composer 使用指定目录作为缓存位置，无需修改配置文件或重新安装。

设置环境变量的方法

不同系统下设置方式略有差异，但原理一致：在运行 Composer 命令前让该变量生效。

• Linux / macOS（临时）：在终端中执行 export COMPOSER_CACHE_DIR="/path/to/your/cache" && composer install
• Linux / macOS（永久）：将 export COMPOSER_CACHE_DIR="/path/to/your/cache" 加入 ~/.bashrc 或 ~/.zshrc，然后运行 source ~/.zshrc
• Windows（CMD）：运行 set COMPOSER_CACHE_DIR=C:\my-composer-cache && composer install
• Windows（PowerShell）：运行 $env:COMPOSER_CACHE_DIR="C:\my-composer-cache"; composer install

验证是否生效

设置后可通过以下方式确认 Composer 是否使用了新路径：

• 运行 composer config --global cache-dir —— 它会显示当前生效的缓存路径（受环境变量影响）
• 执行 composer clear-cache 后检查目标目录是否出现 repo、files、downloads 等子目录
• 首次运行 composer install 后观察目标目录体积变化

注意事项和常见问题

这个变量优先级高于全局配置中的 cache-dir，但低于命令行显式传入的 --cache-dir 参数。

• 目录需有读写权限，Composer 不会自动创建父级路径，确保路径存在且可写
• 若同时设置了 COMPOSER_HOME，它不影响 COMPOSER_CACHE_DIR，两者可独立配置
• Docker 环境中建议用 -e COMPOSER_CACHE_DIR=/tmp/composer-cache 挂载并复用缓存层
• 多用户共享机器时，避免所有人共用同一缓存目录，可能引发权限或冲突问题

基本上就这些。只要环境变量在 Composer 进程启动前就位，它就会安静地用上你指定的位置。