必须手动删除 vendor 中对应包目录并强制更新:先 rm -rf vendor/vendor-name/package-name,再 composer update vendor-name/package-name --no-cache,同时清 VCS 缓存、执行 composer dump-autoload -o 并重置 OPCache。

本地 path 类型包改了代码,但 composer update 不生效、类还是旧的、甚至 Class not found —— 这不是 Composer 没装上,而是它根本没真正重载你的本地包,元数据、symlink、autoload 全卡在旧状态里。
删 vendor 子目录 + 强制 update 才算真刷新
composer update vendor/package-name 默认会复用已安装的目录,哪怕你改了本地 composer.json 或源码,它也不删不重建。必须手动干预:
- 先删掉对应包的安装目录:
rm -rf vendor/vendor-name/package-name(注意不是整个vendor/) - 再运行:
composer update vendor-name/package-name --no-cache - 加
--no-cache是为了跳过~/.composer/cache/files/里的旧 ZIP,避免误解压 - 如果包用了 Git 仓库(比如
type: "package"+source),还得清 VCS 缓存:rm -rf ~/.composer/cache/vcs/*(Linux/macOS)或对应 Windows 路径
为什么 composer clear-cache 没用?
这个命令只清 ~/.composer/cache/files/(ZIP 包)和部分 vcs/(Git clone),但完全不碰三处关键状态:
-
vendor/composer/installed.json:记录当前 symlink 指向哪,改了本地路径它不知道 -
vendor/vendor-name/package-name/下的 symlink:指向旧 commit 或旧路径,不会自动更新 -
composer.lock里的source.type: "path"条目:即使你改了本地包的composer.json,lock 文件仍固守旧快照
所以光清缓存,composer update 依然读 lock、走 symlink、跳过 autoload 重建。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
Class not found 真因是 autoload 没重建
本地包装完后是 symlink,但 PSR-4 映射、classmap、autoload 文件不会自动重生成——尤其当你改过本地包的 composer.json 里 autoload 字段,或主项目没跑 dump。
- 确认本地包的
composer.json里autoload配置正确(比如"App\": "src/"末尾有反斜杠) - 主项目必须执行:
composer dump-autoload(不是只在本地包里跑) - 如果用了
classmap或新增了文件,加-o强制优化:composer dump-autoload -o - 线上环境别忘了清 OPCache:
opcache_reset()或重启 PHP-FPM,否则 autoload.php 的映射还是旧的
验证是否真重载成功
别信终端输出“Updating”,要看日志里有没有真实触发重读:
- 加
-vvv运行:composer update vendor-name/package-name -vvv - 关键线索是出现:
Reading ./../my-local-package/composer.json(说明读了你本地路径) - 如果看到的是:
Using version x.x.x from cache或Reading /path/to/cache/.../composer.json,说明还在走缓存或旧快照 - 顺手检查 symlink:
ls -la vendor/vendor-name/package-name,目标路径必须是你改过的本地目录,不能指向缓存或旧 commit
最顽固的点往往不在 Composer 命令本身,而在 symlink 指向、autoload.php 生成时机、以及 OPCache 这三层缓存叠在一起——漏掉任意一层,都会让你以为“已经刷新了”。










