必须手动运行 composer dump-autoload,否则新增类、改路径或调换命名空间后 new 时会报 Class not found;Composer 仅在 install/update 时自动生成 autoload 文件,不监听文件变化,改类内部代码除外。

必须手动运行 composer dump-autoload,否则新增类、改路径或调换命名空间后,new 时一定报 Class not found。
为什么 composer dump-autoload 不是自动触发的
Composer 只在 composer install 或 composer update 时顺带执行一次自动加载文件生成;它不会监听文件系统变化,也不会在你保存 AuthController.php 后悄悄更新映射。只要你改了 composer.json 中的 psr-4 路径、新增了一个类、或者把类挪到了别的目录,就必须显式运行该命令。
- 只改类内部代码(比如加个
echo),不用dump-autoload - 删了类文件但没运行
dump-autoload,旧映射还在,new时仍会尝试加载已不存在的路径,直接Warning: require(...) - 用 IDE 重命名类或移动文件后,容易漏掉这步——这是本地开发中最常踩的坑
composer dump-autoload 常用参数组合
默认命令只生成 PSR-4/PSR-0 映射,不优化性能;生产环境和调试场景需要不同配置:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
-
composer dump-autoload -o:生成classmap加速加载,适合部署,但会忽略files类型的全局函数文件 -
composer dump-autoload --classmap-authoritative -o:告诉 autoloader “classmap 就是全部类”,不再 fallback 到文件系统扫描;性能更高,但新增测试类却忘了dump,立刻Fatal error -
composer dump-autoload --no-dev:跳过autoload-dev部分(如tests/),减小 autoload 体积,适合上线部署
确认 vendor/autoload.php 是否已更新
别只看命令有没有报错——要验证映射是否真写进去了:
- 打开
vendor/composer/autoload_psr4.php,检查数组里是否有你声明的命名空间,例如:'App\' => array($baseDir . '/src') - 如果看到的是空数组或旧路径,说明
dump-autoload没生效,可能因为当前目录不是项目根目录,或composer.json格式有误(比如少了个逗号) - 运行
composer dump-autoload --verbose可看到实际扫描了哪些目录、加载了多少类,便于定位遗漏
PHP 脚本里引入 vendor/autoload.php 的顺序不能错
require 'vendor/autoload.php' 必须出现在任何类实例化之前,哪怕只差一行:
- ❌ 错误写法:
$ctrl = new AppController(); require 'vendor/autoload.php';→ 必报Class 'AppController' not found - ✅ 正确写法:
require 'vendor/autoload.php'; $ctrl = new AppController(); - CLI 脚本尤其容易出这个问题:某个依赖包提前加载了部分类,掩盖了缺失
autoload.php的问题,一到新环境就崩
最易被忽略的一点:PSR-4 映射对反斜杠和斜杠极其敏感——"App\": "src/" 中的双反斜杠是 JSON 转义,实际值必须是单反斜杠;路径末尾的 / 也不能省,否则拼接出的文件路径会变成 srcController/HomeController.php 而非 src/Controller/HomeController.php。

















