php内置服务器不自动加载autoloader，需在router.php首行显式require vendor/autoload.php；类找不到主因是autoload路径配置错误、文件命名不匹配或classmap缓存未更新。
为什么 php -S 启动后类找不到，但 composer dump-autoload 又没报错？
PHP 内置服务器不读取 autoload.php 的自动重载机制，它只管按路由规则转发请求，不会主动触发 Composer 的 autoloader 初始化。你写的 require 'vendor/autoload.php' 如果漏了、位置错了，或者被条件逻辑跳过，类就直接 Class not found。
常见错误现象：Fatal error: Uncaught Error: Class "AppControllerHome" not found，但 composer show 能看到包，composer dump-autoload -o 也成功。
- 确认入口脚本（如
router.php）第一行就require __DIR__.'/vendor/autoload.php';，别放在if里或函数中 - 检查
composer.json的"autoload"配置是否覆盖了你的类路径，比如用了"psr-4": {"App\": "src/"}，但实际类文件在app/下 -
php -S默认工作目录是启动命令所在路径，如果在项目根目录外执行，__DIR__就会指向错地方
怎么让 php -S 实时响应 composer.json 修改？
Composer 本身不提供热重载，但你可以用最轻量的方式绕过手动 dump-autoload：把 autoload.php 改成每次请求都重新生成（仅开发用）。
性能影响明显——每次请求都跑一次 ClassLoader::loadClass() 的完整查找链，但调试阶段可接受；正式环境绝对禁用。
立即学习“PHP免费学习笔记（深入）”；
- 在
router.php开头加：if (getenv('APP_ENV') === 'dev') { require __DIR__.'/vendor/composer/autoload_real.php'; $loader = ComposerAutoloadClassLoader::getLoader(); $loader->setPsr4(['App\' => [__DIR__.'/src']], true); // 强制刷新映射 } - 更稳妥的做法：用
inotifywait（Linux/macOS）监听composer.json和src/变化，触发composer dump-autoload --no-scripts，再发个信号通知服务器 reload（需配合kill -USR1或重启） - Windows 用户可用
watchmedo+pip install watchdog模拟类似行为
composer dump-autoload -o 在 php -S 下为什么有时反而失效？
-o（optimize）会把 PSR-4 映射编译进 vendor/composer/autoload_classmap.php，但它依赖文件系统路径的静态快照。一旦你移动、重命名类文件，或改了 composer.json 但没重新 dump，classmap 就会指向旧路径或完全缺失。
典型表现：修改类名后仍加载旧版本，或新增类在 -o 模式下根本不可见，但去掉 -o 就正常。
- 调试期间一律用
composer dump-autoload（不带-o），避免 classmap 缓存干扰 - 检查
vendor/composer/autoload_static.php中的$classMap数组是否包含你期望的类 —— 如果没有，说明dump-autoload没生效或路径配置有误 -
composer dump-autoload -a（--apcu）在php -S下无效，因为 APCu 是进程级缓存，而内置服务器每个请求是新进程
怎么快速验证自动加载路径是否真被识别？
别猜，直接查 ClassLoader 实例里的注册状态。这是最接近底层的验证方式，比看报错更早发现问题。
在任意能执行 PHP 的位置（比如路由文件开头）插入：
$loader = require __DIR__.'/vendor/autoload.php';
var_dump($loader->getPrefixesPsr4()); // 看 App\ 是否指向 src/
var_dump($loader->findFile('AppControllerHome')); // 返回具体文件路径，或 null
- 如果
findFile()返回null，说明命名空间、文件名（必须匹配类名）、文件扩展名（.php）三者至少一个不一致 - 注意大小写：Linux 下
src/App/Controller/home.php不会被加载，类名是Home就必须是Home.php - 如果用的是
"files"类型 autoload，确保对应文件里没有语法错误，否则整个 autoloader 会静默失败
ClassLoader 实例里。多打一行 var_dump($loader)，比翻十遍文档快。 
