Composer update 不需要单独配置缓存路径,它复用全局缓存机制,仅 COMPOSER_CACHE_DIR 环境变量或 cache-dir 全局配置生效,且优先级为:环境变量 > 全局配置 > 默认路径。

Composer update 不需要单独配置“默认缓存路径”——它复用全局缓存机制,真正起作用的只有 COMPOSER_CACHE_DIR 环境变量或 cache-dir 全局配置,且优先级明确:环境变量 > 全局配置 > 默认路径。
为什么 composer update 本身不接受缓存路径参数
composer update 是依赖解析与安装命令,不负责决定缓存存哪;缓存路径由 Composer 运行时统一读取,和 install、require 完全共用同一套逻辑。你改了缓存路径,所有命令立刻生效,无需为 update 单独设置。
常见误操作是试图在 composer.json 里写 "cache-dir" ——这无效,cache-dir 只支持全局配置(config --global)或环境变量,项目级配置被忽略。
怎么让 composer update 真正用上自定义缓存路径
-
COMPOSER_CACHE_DIR环境变量优先级最高,设了就直接生效,连composer config --global cache-dir都会被跳过 - Linux/macOS:在
~/.zshrc或~/.bashrc中添加export COMPOSER_CACHE_DIR="/path/to/my-cache"(必须是绝对路径) - Windows PowerShell:
[Environment]::SetEnvironmentVariable("COMPOSER_CACHE_DIR", "D:\my-composer-cache", "User") - 验证是否真生效:运行
composer diag,看输出中Cache directory:行是否为你指定的路径——别信composer config --global cache-dir的输出,它只是显示配置值,不是真实路径 - 目标目录需存在且当前用户有读写权限:
mkdir -p /path/to/my-cache && chmod 755 /path/to/my-cache
缓存路径改了但 composer update 还走旧缓存?检查这几处
现象:明明设了 COMPOSER_CACHE_DIR,composer update 却仍从 ~/.composer/cache 读取或写入。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 终端没重开:环境变量只对新启动的 shell 生效,旧终端不会自动刷新
- 用了 Docker 或 CI 脚本:容器内未注入该环境变量,或构建阶段 PATH/ENV 未继承
- 执行命令时加了
--no-cache或COMPOSER_CACHE_DIR=""(空值会回退到默认路径) -
composer diagnose输出的Cache directory:和你预期不符,说明环境变量根本没生效,先查echo $COMPOSER_CACHE_DIR(Linux/macOS)或echo $env:COMPOSER_CACHE_DIR(PowerShell)
缓存目录结构和清理要点
Composer 缓存不是扁平存放,而是按类型分层:
-
files/:下载的 zip/tar 包,受cache-files-ttl控制(默认 6 个月) -
repo/:Packagist 等仓库的 JSON 元数据 -
vcs/:Git clone 的 bare repos,体积最大,也最常被误删导致重复克隆
手动清理建议用 composer clear-cache,而不是直接 rm -rf ——它会同步清空内存中缓存索引,避免下次 update 出现校验失败或元数据错乱。如果非要删目录,务必确保 Composer 进程已退出,否则可能损坏缓存锁文件。










