Composer如何更改全局缓存目录COMPOSER_CACHE_DIR

composer默认缓存目录位于用户主目录下，可通过设置 COMPOSER_CACHE_DIR环境变量 自定义路径。1. 在 linux/macos 中，编辑~/.bashrc 或~/.zshrc 并添加 export COMPOSER_CACHE_DIR=”/ 自定义路径 ”；windows 则在系统环境变量中新建该变量并指定路径。2. 通过 composer config –global cache-dir 或 composer diagnose 验证路径是否生效。3. 确保目标目录存在且有读写权限，避免使用中文或空格，适用于 CI/CD 时建议按环境独立配置。修改后 Composer 将使用新路径存储缓存数据。

Composer 的全局缓存目录默认位于系统用户的主目录下（如 Linux/macOS 的 ~/.cache/composer 或 windows 的 C:Users 用户名 appDataLocalComposer）。如果你想更改这个路径，可以通过设置 环境变量 COMPOSER_CACHE_DIR 来实现。

1. 设置 COMPOSER_CACHE_DIR 环境变量

Composer 会优先读取 COMPOSER_CACHE_DIR 环境变量来决定缓存存放位置。你可以在系统或用户级别设置该变量。

Linux / macOS 示例：

打开终端，编辑 shell 配置文件（如 ~/.bashrc、~/.zshrc 或 ~/.profile），添加以下行：

export COMPOSER_CACHE_DIR="/path/to/your/custom/cache"

例如：

export COMPOSER_CACHE_DIR="$HOME/.composer-cache"

保存后执行：

source ~/.bashrc

即可生效。

Windows 示例：

右键“此 电脑”→“属性”→“高级系统设置”→“环境变量”，在用户或系统变量中新增：

• 变量名：COMPOSER_CACHE_DIR
• 变量值：D:composer-cache（或其他自定义路径）

确定保存后，重启命令行 工具 即可生效。

2. 验证缓存目录是否更改成功

运行以下命令查看 Composer 当前使用的缓存路径：

composer config --global cache-dir

或者直接查看信息：

composer show -v

也可以使用诊断命令：

composer diagnose

输出中会显示缓存目录路径，确认是否已更新为你设置的路径。

3. 注意事项

• 确保目标目录存在且有读写权限。
• 路径尽量避免中文或空格，防止潜在兼容问题。
• 如果你在 CI/CD 或多用户环境中使用，建议为每个环境单独配置。
• 修改后，Composer 将从新路径读写包缓存、Zip 文件和日志等数据。

基本上就这些。通过环境变量控制 COMPOSER_CACHE_DIR 是最直接有效的方式，无需修改 Composer 源码或全局 配置文件。不复杂但容易忽略。