正常,Composer remove 不会自动重建 autoload 文件,需手动执行 composer dump-autoload;若类仍找不到,需检查 autoload 配置残留、路径大小写及 classmap 是否更新。

remove 后 vendor/autoload.php 没变是正常现象
Composer 的 remove 命令只删包、删 composer.json 里的条目、删 vendor/ 下对应目录,它**不会自动重生成 autoload 文件**。这是设计使然,不是 bug。autoload 文件(如 vendor/autoload.php 和 vendor/composer/autoload_*.php)由 dump-autoload 触发生成,remove 不包含这步。
必须手动运行 composer dump-autoload
删完包后,立刻执行:
composer dump-autoload
这会重新扫描 composer.json 中的 autoload 和 autoload-dev 配置,重建所有 autoload 映射文件。常见遗漏点:
- 没加
--optimize或-o:生产环境建议加上,它会把 PSR-4/PSR-0 映射合并为一张静态数组,提升加载速度 - 误用
composer install或update代替:这两个命令在 lock 文件存在时不一定触发 autoload 重建,尤其当依赖没变化时 - 在 CI/CD 中漏掉该步骤:某些部署脚本只跑
install,但 remove 是人工操作,后续未同步 dump
检查 composer.json 的 autoload 配置是否残留
如果执行了 dump-autoload 但类仍能被加载(或报错依旧),很可能是 composer.json 里还留着已删除包的 autoload 声明,比如:
"autoload": {
"psr-4": {
"Old\\Package\\": "vendor/old/package/src/"
}
}
这类路径早已不存在,但 Composer 不校验路径有效性,照常写入 autoload 文件,导致后续加载失败或静默跳过。应手动清理:autoload / autoload-dev 下所有指向已删包的映射项。
autoload 文件更新但类仍找不到?重点查命名空间和路径
dump-autoload 成功不代表类一定能加载,常见断点:
- 被删包的类被项目代码直接
use或new,但没删对应调用——此时报Class not found是预期行为,不是 autoload 问题 - 路径大小写不一致(尤其在 macOS/Linux):autoload 生成基于配置路径,但文件系统区分大小写时,
"src/"和实际"SRC/"会导致映射失效 - 使用了 classmap 且未更新:若配置了
"classmap": ["src"],删包后需确认该目录下没残留旧类文件,否则会被继续扫描进去
最稳妥的验证方式是打开 vendor/composer/autoload_psr4.php,搜索你期望加载的命名空间,看对应路径是否存在、是否指向有效目录。










