PHP类找不到主因是命名空间声明位置错误或PSR-4路径映射不匹配：namespace须紧贴<?php后无空行/注释；composer.json中前缀需双反斜杠结尾、路径须正斜杠结尾；大小写与文件名必须完全一致。
PHP 类找不到，八成是命名空间和 PSR-4 路径映射没对上——不是 autoload 没注册，而是类名解析路径拼错了，或者文件根本不在预期位置。
namespace 声明位置和作用域边界怎么卡准
PHP 对 namespace 的声明位置极其敏感：它必须紧贴 <?php 标签之后，前面不能有任何输出、空行或注释。一旦错位，整个文件的类、函数、常量就全掉进全局命名空间里，后续 use 或自动加载都会失效。
常见错误现象包括：Class 'AppControllersHome' not found，但文件明明在 src/Controllers/Home.php；或者 new DateTime() 报错，其实是误写了 new DateTime() 却忘了前面的反斜杠。
-
namespace后面不能跟空格或换行，必须是namespace AppControllers;这种紧凑写法 - 一个文件只应定义一个命名空间，多级结构用反斜杠分隔，如
AppModelsUser - 想在命名空间内调用全局类（如
DateTime、Exception），必须加前导反斜杠：DateTime，否则 PHP 会去当前命名空间下找AppModelsDateTime - 函数和常量有回退机制，但类没有——这点极易被忽略，也是“为什么
strlen()能用而User找不到”的根源
PSR-4 映射配置中那些必须咬死的字符细节
Composer 的 composer.json 里写 "App\": "src/" 看似简单，但漏掉一个反斜杠或斜杠，路径就全崩了。PSR-4 不做容错推断，只按字面规则拼接。
立即学习“PHP免费学习笔记（深入）”；
典型错误是把前缀写成 "App": "src/"（缺末尾反斜杠）或 "App": "src"（路径缺末尾斜杠），结果 AppControllersHome 被拼成 srcControllers/Home.php 或 srcControllers/Home.php，而不是正确的 src/Controllers/Home.php。
- 命名空间前缀必须以双反斜杠结尾：
"App\":，JSON 中单反斜杠会被转义，所以得写两个 - 路径值必须以正斜杠结尾：
"src/"，否则子目录拼接时会粘连 - 大小写必须完全一致：Linux 下
Controllers和controllers是两个目录，类名HomeController必须对应HomeController.php，不能是homecontroller.php - 改完
composer.json后，必须运行composer dump-autoload，否则vendor/autoload.php里的映射表不会更新
spl_autoload_register 手动实现时路径拼接的陷阱
手动写加载器看似可控，但容易在字符串处理环节翻车。核心逻辑就是把类名中的 替换成 /，再补上 .php，但替换时机和范围不对，就会加载错文件。
比如 AppModelsUser，若直接 str_replace('\', '/', $class) 得到 App/Models/User，再拼路径 $base_dir . $file . '.php'，看起来没问题——但如果 $base_dir 是 __DIR__.'/src'（没加斜杠），最终路径就成了 .../srcApp/Models/User.php。
- 必须先截掉命名空间前缀，再替换分隔符：
substr($class, strlen($prefix))，避免把前缀本身也当路径处理 -
$base_dir值末尾要确保有斜杠，或拼接时显式加：$base_dir . '/' . $relative_path . '.php' - 用
file_exists()判断前，建议先realpath()或dirname()检查目录是否存在，避免静默失败 - 不要用
require，要用require_once，防止同一类被重复加载导致 “Cannot redeclare class” 错误
类名解析失败时怎么快速定位是哪一环断了
报 Class not found 时，别急着重写 autoload，先确认三件事：类名是否完整限定、路径是否真存在、autoload 是否真的触发了。
最有效的验证方式是在加载器函数里加日志或 var_dump，看 $class 参数传进来的是什么、拼出来的 $file 是什么、file_exists($file) 返回什么。很多问题其实出在开发机 Windows 下不区分大小写，上线 Linux 就挂了。
- 检查
get_declared_classes()输出，确认目标类是否已加载过 - 在入口文件顶部加
echo spl_autoload_functions();，看你的加载器是否注册成功 - 临时在加载器里加
if ($class === 'AppControllersHome') { var_dump($file); die; }，直击关键路径 - 注意 IDE 自动补全有时会帮你加上错误的
use，比如把AppModelsUser补成AppModelUser（少了个 s），这种拼写差异极难肉眼发现
真正卡住人的往往不是概念，而是命名空间声明那行代码前有没有空格、composer.json 里那个反斜杠到底该写几个、Linux 文件系统里大小写差一个字母就找不到文件——这些点不试一次，光看文档永远记不住。
