class not found 错误主因是命名空间、文件路径与 composer autoload 配置三者未对齐；需严格匹配大小写、检查 psr-4 映射、执行 composer dump-autoload -o、验证文件存在性及权限，并排查 loader::addnamespace 或 opcache 缓存干扰。
Class not found 不是文件丢了，而是 PHP 根本没去加载它——问题出在命名空间、路径、autoload 配置三者之间没对齐。
命名空间声明与类名大小写是否严格匹配
PHP 在 PSR-4 自动加载下对大小写极其敏感，哪怕只错一个字母或大小写不一致，就会直接失败。
-
namespace appcontroller;和namespace AppController;是两个完全不同的命名空间，不能混用 - 类文件名必须和类名完全一致：
UserController类必须存为UserController.php，不是usercontroller.php或user_controller.php - 调用时若用了
use，注意别漏掉反斜杠：use AppControllersUserController;（末尾无多余空格） - Linux 服务器上，
app/controllers/和app/Controllers/是两个目录，路径错一级就找不到
composer.json 的 psr-4 映射是否正确且已生效
映射写错了，Composer 就不知道该去哪找；写对了但没重建 autoload 文件，等于白写。
- 检查
composer.json中"psr-4"段是否包含目标命名空间，例如："App\": "app/"（注意双反斜杠和结尾斜杠） - 确认路径是相对项目根目录的，
"app/"表示从./app/开始找，不是./src/app/ - 改完配置后必须运行：
composer dump-autoload -o（-o启用优化，生产环境建议带上） - CI/CD 构建后部署到服务器时，如果只执行
composer install而没跑dump-autoload，新加的类一定报错
类文件是否真实可读且语法合法
文件存在 ≠ 能被加载。权限、语法错误、.gitignore 忽略都可能导致“看不见”。
- 根据报错类名推导路径，比如
AppModelsPost→ 运行：ls -l app/Models/Post.php确认存在 - 用
php -l app/Models/Post.php检查语法，有 parse error 会导致类注册中断 - Web 服务器用户（如
www-data）必须有读取权限：chmod 644 app/Models/Post.php - 检查
.gitignore是否误写了app/Models/*.php之类规则，导致文件实际未部署
ThinkPHP 中 Loader::addNamespace() 的隐式注册容易被忽略
这个方法绕过 Composer，手动注册命名空间，但不会写入 autoload 文件，也不受 dump-autoload 影响。
- 常见于插件、多应用或
app/common.php中调用：Loader::addNamespace('addon', '../addon/') - 5.1+ 支持，但 6.x 已移除，升级时这类代码会静默失效
- 它走的是运行时查找，性能不如 Composer 的静态映射，且 IDE 很难追踪，调试时容易漏看
- 如果类报错但文件明明存在，优先 grep 全项目搜
Loader::addNamespace和thinkLoader
最麻烦的情况是：命名空间、路径、配置全对，但类仍找不到——往往是因为某处用了 require_once 错误加载了另一个同名类，或者 opcache 缓存了旧的 autoload 映射，这时候得清 opcache 并确认 vendor/composer/autoload_psr4.php 里真有对应条目。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
