可通过五种方式修改 Composer 缓存目录：一、全局命令配置；二、手动编辑 config.json；三、环境变量临时覆盖；四、单项目配置；五、验证生效。
如果您希望将 Composer 的缓存文件存储到指定的本地目录，而非默认位置，则需要修改其配置中的 cache-dir 设置。以下是实现此目标的具体操作步骤：
一、通过全局配置命令设置 cache-dir
该方法直接修改 Composer 全局配置文件，适用于所有项目，且无需手动编辑 JSON 文件。执行命令后，Composer 会自动更新 config.json 并应用新路径。
1、在终端中运行以下命令，将缓存目录设为自定义路径（例如 /data/composer-cache）：
2、composer config -g cache-dir /data/composer-cache
3、确认配置已生效，可执行 composer config -g cache-dir 查看当前值。
二、手动编辑全局配置文件
该方法适用于需要批量修改或脚本化部署的场景，通过直接编辑 Composer 的全局 config.json 文件实现路径设定。
1、定位全局配置文件路径：通常为 ~/.composer/config.json（Linux/macOS）或 C:\Users\用户名\AppData\Roaming\Composer\config.json（Windows）。
2、用文本编辑器打开该文件，在 config 对象内添加或修改 cache-dir 字段：
3、"cache-dir": "/mnt/storage/composer_cache"
4、保存文件，确保 JSON 格式合法，无语法错误。
三、通过环境变量临时覆盖 cache-dir
该方法不修改任何配置文件，仅在当前 shell 会话或特定命令执行时生效，适合调试或 CI/CD 环境中按需指定缓存路径。
1、在 Linux/macOS 中执行 export COMPOSER_CACHE_DIR="/tmp/composer_cache"
2、在 Windows 命令提示符中执行 set COMPOSER_CACHE_DIR=C:\temp\composer_cache
3、随后运行 composer install 或其他命令，Composer 将优先使用该环境变量指定的路径。
四、为单个项目单独配置 cache-dir
该方法仅影响当前项目的 Composer 行为，不会干扰全局或其他项目，适用于多团队协作中隔离缓存的场景。
1、进入项目根目录，确保存在 composer.json 文件。
2、执行命令：composer config cache-dir ./storage/composer-cache
3、该操作会在项目级 composer.json 的 config 段中写入 cache-dir 字段，并创建对应目录结构。
五、验证缓存目录是否生效
该方法用于确认前述任一配置方式是否正确应用，避免因路径权限、拼写错误或配置层级冲突导致失效。
1、执行 composer config --list | grep cache-dir
2、观察输出中 cache-dir 的实际值是否与预期一致。
3、运行 composer clear-cache 后检查目标目录是否生成 vendor/ 相关子目录及文件。
4、注意：目标路径必须具有当前用户读写权限，且父目录需预先存在
