composer diag 的 Cache directory 行才是真实缓存路径,composer config --global cache-dir 仅显示写入值,不反映环境变量覆盖或配置未生效情况;composer config --list 括号内路径为实际加载位置,是唯一可信依据。

看 composer diag 的 Cache directory 行,不是 composer config --global cache-dir
配置输出值不等于真实行为。composer config --global cache-dir 只显示你“写进去的值”,哪怕它被环境变量覆盖或路径根本不存在,这个命令照样返回你设的那个字符串。真正决定缓存目录的是 composer diag 输出中 Cache directory: 后面的路径——它已合并了 COMPOSER_HOME、COMPOSER_CACHE_DIR 环境变量、配置文件和默认逻辑。
常见错误现象:
- 改了
cache-dir但~/.composer/cache还在疯狂写入 -
composer config --global cache-dir显示/tmp/composer-cache,但du -sh ~/.composer/cache依然增长
这时直接跑:
composer diag
,盯住 Cache directory: 那一行。如果它还是 ~/.composer/cache,说明你的配置没被读到,大概率是 COMPOSER_HOME 指向了别的地方,或者你用 sudo composer 写进了 root 的配置。
composer config --list 显示括号里的路径才是真实生效位置
别信文档里写的“默认在 ~/.composer/config.json”。运行 composer config --list,每行配置后括号里标出的路径,就是 Composer 实际加载该配置的位置。这个输出是唯一可信依据。
关键点:
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 如果括号里是
/root/.composer/config.json,说明你最近用过sudo composer,后续所有 global 操作都走 root 配置 - 如果括号为空或指向一个不存在的路径,大概率是
COMPOSER_HOME被设成了无效值(比如 Windows 下 PowerShell 未展开%APPDATA%) - 项目级配置(
composer.json中的config字段)不会出现在--list的括号路径里,但它会影响行为
改了 vendor-dir 后,autoload 和 bin 调用必须手动同步
vendor-dir 不是“设完就自动迁移”的开关。它只影响后续 composer install 的写入位置,不改变已有代码的引用逻辑。
必须手动处理的几件事:
-
require 'vendor/autoload.php'得改成require 'third-party/autoload.php'(假设你设了"vendor-dir": "third-party") - IDE(如 PHPStorm)会丢失类跳转,需刷新索引或重设
Include Path - CI/CD 脚本里硬编码的
vendor/bin/phpunit必须改成third-party/bin/phpunit -
composer global config bin-dir是只读命令,不能赋值;全局 bin 路径由 Composer 自动推导,要查真实路径得用composer global config bin-dir --absolute
强制指定配置文件时,--config 优先级最高但不持久
临时调试或 CI 场景下,可用 --config=/path/to/my-config.json 强制 Composer 读取指定文件。它优先级高于 COMPOSER_HOME 和所有默认路径,但注意:
- 该文件必须是合法 JSON,且结构完整(不能只写一个
cache-dir字段) -
composer global config命令不会因此改写这个文件,它仍写入默认 global 配置位置 - Windows 下若用 Git Bash 或 WSL,
COMPOSER_HOME可能被分别设置,导致同一命令在不同终端读不同配置
最易被忽略的一点:配置是否生效,从来不是看“你写了什么”,而是看“Composer 最终加载了哪个文件、并从中读出了什么值”。composer diag 和 composer config --list 的输出,就是此刻唯一的事实依据。










