“Class not found”主因是autoload链断裂：vendor/autoload.php未引入、未执行composer dump-autoload，或PSR-4映射缺反斜杠/斜杠；require必须首行、不可包裹、需各入口显式调用；PSR-4依赖精确前缀截取与路径拼接，大小写及路径相对性亦关键。
“Class not found” 不是类写错了，而是 autoload 链在某个环节断了——90% 的问题出在 vendor/autoload.php 没被引入、composer dump-autoload 没执行、或 PSR-4 映射里少了一个反斜杠/斜杠。
为什么 require 'vendor/autoload.php' 必须放在入口文件第一行
这行代码不是“加载类”，而是注册 spl_autoload_register() 回调。PHP 在遇到未定义类（如 new AppController()）时，会立刻遍历已注册的 autoload 处理器；如果这行还没执行，队列为空，直接报错，不给任何机会。
- 不能包在
if、函数体或try/catch里——PHP 解析到new就触发 autoload，此时作用域还没进函数 - CLI 脚本和 Web 入口（如
public/index.php）必须各自显式require，它们不共享 autoload 注册状态 - 用
include替代require_once是隐形炸弹：路径错时不报致命错误，只静默失败，排查成本翻倍 - 框架（如 Laravel）若在
bootstrap前就实例化了某个类，而autoload.php还没引入，同样炸
PSR-4 映射中反斜杠和斜杠为什么不能省
PSR-4 不是模糊匹配，是字符串前缀截取 + 路径拼接。命名空间 "App\" 和路径 "src/" 中的符号是硬分隔锚点，缺一不可。
-
"App\": "src/"→ 类AppControllerHome截去前缀得ControllerHome，\替换为/得Controller/Home，拼上src/→src/Controller/Home.php -
"App": "src/"（命名空间缺\）→App不被识别为有效前缀，跳过 PSR-4 查找，fallback 到 classmap 或失败 -
"App\": "src"（路径缺/）→ 拼成srcController/Home.php，404 - Linux 下大小写敏感：
UserController.php里写class usercontroller，或文件名是usercontroller.php，都找不到
改了 composer.json 为什么还是 Class not found
vendor/autoload.php 是启动器，真正干活的是它加载的 vendor/composer/autoload_psr4.php —— 这个文件是静态 PHP 数组，只在 composer dump-autoload 时重写。改配置不跑命令，等于白改。
立即学习“PHP免费学习笔记（深入）”；
- 常见误操作：手动编辑
vendor/composer/autoload_psr4.php→ 下次dump-autoload直接覆盖，白干 - CI/CD 流水线里漏掉
composer install --no-interaction或composer dump-autoload→autoload_psr4.php根本不存在或过期 - 用了
--no-scripts参数 → 自动加载生成脚本被跳过，映射表不会更新 - 检查是否存在：
ls vendor/composer/autoload_psr4.php；确认内容是否含你新加的映射项
classmap 和 PSR-4 混用时的优先级与陷阱
ClassLoader 内部按固定顺序尝试：PSR-4 → classmap → PSR-0 → files。PSR-4 匹配成功就不再往下查；但 classmap 是全量扫描结果，一旦生成就不随文件移动/删除自动更新。
- classmap 适合无命名空间的老代码、第三方库、或你想用 O(1) 查找加速的场景；加到
"classmap": ["legacy/"]后必须composer dump-autoload - PSR-4 和 classmap 都扫到了同一个类 → PSR-4 优先生效，但 classmap 条目仍存在，只是不触发
- 删了 classmap 目录下的类文件，但没再跑
dump-autoload→ classmap 表里还存着旧路径，include时直接 fatal error -
files是预加载，不是按需加载：写进"files": ["src/helpers.php"]，每次请求都会require_once它，别往里塞类定义
最易被忽略的点：PSR-4 映射路径是相对于 composer.json 所在目录的，不是项目根目录、也不是 vendor/；dump-autoload -o 生成的 autoload_classmap.php 是全量快照，开发阶段慎用——改一个类就得重跑，失去动态性。
