最可靠方式是设置 COMPOSER_CACHE_DIR 环境变量，优先级最高且不依赖配置文件权限；其次可选 composer config --global cache-dir（仅当无法设环境变量时）；避免在 composer.json 中硬编码路径。
修改 Composer 缓存目录：用 COMPOSER_CACHE_DIR 环境变量最可靠
Composer 默认把下载的包缓存到用户主目录下的 ~/.composer/cache（Linux/macOS）或 %APPDATA%\Composer\Cache（Windows），但这个位置可能磁盘空间小、权限受限，或需要统一管理。改缓存路径最稳妥的方式是设环境变量——它优先级最高，且不依赖全局配置文件是否可写。
常见错误现象：composer install 仍往旧路径写缓存，或报 Permission denied；这是因为只改了 config.json 却没生效，或用了 composer config --global cache-dir 但被环境变量覆盖。
- Linux/macOS：在 shell 配置里加
export COMPOSER_CACHE_DIR="/path/to/your/cache"，然后source ~/.bashrc或重启终端 - Windows（CMD）：运行
setx COMPOSER_CACHE_DIR "D:\my-composer-cache"（需重启 CMD） - Windows（PowerShell）：用
[System.Environment]::SetEnvironmentVariable('COMPOSER_CACHE_DIR', 'D:\my-composer-cache', 'User') - 验证是否生效：运行
composer config --global --list | grep cache-dir，输出应显示你设的路径；再执行composer clear-cache，观察实际清空的是哪个目录
用 composer config 改全局缓存路径：仅当无法设环境变量时考虑
如果部署环境不允许改环境变量（比如某些 CI/CD 沙箱），可以用 composer config --global cache-dir 写入全局配置。但要注意：它只影响当前用户，且会被 COMPOSER_CACHE_DIR 环境变量覆盖——很多人改了这里却没生效，就是被环境变量“静默接管”了。
使用场景：开发机上临时切换缓存位置做测试；或者团队内部统一用脚本初始化 Composer 配置。
- 执行
composer config --global cache-dir "/mnt/ssd/composer-cache" - 该命令会修改
~/.composer/config.json中的cache-dir字段 - 若该文件被设为只读，或
~/.composer权限不对（比如 root 创建但当前用户无写权），命令会失败并提示Could not write to file - 注意：此方式对
root用户无效（除非也给 root 单独配），CI 脚本中用--no-interaction和--quiet避免卡住
cache-dir 参数差异：全局 vs 项目级 vs 运行时临时指定
Composer 的缓存路径有三层控制：环境变量 > 全局 config > 项目 config。项目级配置（即 composer.json 同级的 composer.json 里写 "config": {"cache-dir": "..."} ）基本不用——它只对当前项目生效，但缓存本身是跨项目的，设了反而容易混乱。
真正有用的运行时临时指定，是用 -d 参数：
-
composer -d /tmp/composer-tmp install：临时指定整个 Composer 工作目录（含缓存），但不推荐——它会把 vendor、cache、bin 全挪过去，容易出错 - 更安全的做法是只动缓存：结合环境变量，如
COMPOSER_CACHE_DIR=/tmp/composer-cache composer install - 不要在
composer.json的config块里硬编码绝对路径（比如/home/user/.composer/cache），否则换机器就失效
性能与兼容性影响：缓存目录位置选 SSD 还是网络盘？
缓存目录 IO 性能直接影响 composer install 和 update 速度，尤其在大量依赖或低速磁盘上。实测表明：从 HDD 切到本地 SSD，clear-cache + install 可快 2–3 倍；而挂载 NAS 或 Windows 共享目录，常因文件锁或延迟导致 composer update 卡死或报 file could not be downloaded。
- 避免将缓存放在加密卷（如 macOS FileVault 启用时的主目录）、OneDrive/Google Drive 同步目录下——Composer 解压时频繁创建/删除临时文件，同步客户端会争抢句柄
- Docker 场景下，建议用 volume 挂载宿主机缓存目录（如
-v /host/cache:/root/.composer/cache），而非绑定到容器内路径，否则每次重建容器都重下包 - PHP 8.1+ 在某些 ext-zip 版本下，若缓存目录所在文件系统不支持 hard link（如某些 FAT32 或网络文件系统），解压时会回退到 copy，变慢且占双倍空间
缓存目录不是“设完就完”，它和你的部署方式、文件系统特性、甚至 PHP 扩展版本都咬合得挺紧。改之前先看 df -h 和 mount 输出，比盲目套命令有用得多。
