Composer 不清理共享依赖,需通过 composer update --with-dependencies 清理未显式声明的间接依赖;先验证是否真无用,再删 composer.json 中的引用,最后清 autoload 缓存和 OPcache。

Composer 本身不清理“共享依赖”——它只按声明管理,所谓“共享”其实是误判或未显式声明的隐式依赖。 真正要处理的,是那些被多个包共同拉入、但项目代码里根本没用到的间接依赖(transitive dependencies),比如 guzzlehttp/psr7 被 symfony/http-client 和 laravel/framework 同时 require,而你实际只用了 Laravel 的 HTTP 功能,却从没调用过 PSR-7 接口。
先确认是不是真“无用”,别删错核心传递依赖
很多包看似“共享”,实则是上游组件运行必需的。直接删会破坏依赖图:
- 运行
composer why guzzlehttp/psr7查谁在引用它;如果输出含symfony/http-client或laravel/framework,说明它是被硬依赖的,不是冗余 - 全局搜索项目代码:用
grep -r "Psr\Http" . --include="*.php"或 IDE 全局查找use Psr\Http,确认是否有主动调用 - 检查配置文件(如
config/services.php)是否注册了基于该包的类名或驱动 - 某些包(如
psr/log)是框架级契约,删了会导致Class not found—— 它们属于“基础设施依赖”,不是“业务无用包”
composer remove 不适用于共享依赖,得靠 composer update --with-dependencies
composer remove 只接受显式声明在 composer.json 中的包,对传递依赖无效。强行对 guzzlehttp/psr7 执行该命令会报错:Package guzzlehttp/psr7 is required by ...。正确做法是让 Composer 重新计算依赖树:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 先确保目标包**不在**
composer.json的require或require-dev中(手动删掉那行) - 运行
composer update --with-dependencies:它会识别已移除的顶层包,并顺带清理其“仅被该包引用”的子依赖 - 如果想更激进,可加
--dry-run预览将删哪些包:composer update --with-dependencies --dry-run - 注意:不要用
composer update guzzlehttp/psr7—— 这是升级,不是清理
vendor 里残留的共享包目录,必须靠 install/update 触发物理删除
执行 composer update --with-dependencies 后,vendor/ 下对应目录可能还在——这不是 bug,是 Composer 的同步机制:
- Composer 只在
install或update的最终阶段才清理磁盘文件;update --with-dependencies默认会触发,但如果中途失败或加了--no-install,就只改composer.lock - 验证是否真删干净:
ls vendor/guzzlehttp/psr7应报No such file or directory;再跑composer show guzzlehttp/psr7应返回Package not found - 若仍存在,补一步
composer install --no-dev(生产环境)或composer install(开发环境),强制按 lock 文件重建vendor/ - 别手动
rm -rf vendor/guzzlehttp/psr7—— 下次composer install会把它拉回来,只要它还在composer.lock里
autoload 缓存和 classmap 是最常被忽略的“假残留”点
即使 vendor/ 目录已空,项目仍可能报 Class not found 或反常地能 new 出类——问题往往出在自动加载缓存:
- 运行
composer dump-autoload -o强制重生成优化 classmap;如果项目启用了"classmap-authoritative": true(Laravel 9+ 默认),这步不可跳过 - 检查
composer.json的autoload.psr-4或autoload.files是否还硬写了已删包的路径(例如"GuzzleHttp\Psr7\": "vendor/guzzlehttp/psr7/src/"),手动删掉 - 某些 CI 或 Docker 环境会缓存
vendor/composer/autoload_classmap.php,dump 后仍异常,可加--no-cache参数重试:composer dump-autoload -o --no-cache - OPcache 或 APCu 缓存也可能保留旧类映射,上线前记得清
opcache_reset()或重启 PHP-FPM
真正难清理的从来不是 vendor 目录里的文件,而是代码里没删净的 use、配置里没改掉的驱动名、服务提供者里没注销的绑定——这些不会被任何 Composer 命令触碰,只能靠人工扫。

















