类找不到主因是命名空间不匹配，需检查声明位置（必须文件顶部无bom/空行）、路径映射（psr-4要求命名空间与物理路径严格对应）、use语句用法（注意全局类前加反斜杠、避免同名冲突）及自动加载更新（改配置后必执行composer dump-autoload）。
类找不到，八成不是代码写错了，而是命名空间没对上。核心问题通常出在声明、引用、路径或自动加载这四个环节，理清逻辑比盲目改代码更有效。
命名空间声明位置错误
namespace必须出现在文件最顶部，前面只能有declare语句，不能有任何输出、空行、BOM头或注释。哪怕多一个空格或UTF-8 BOM，PHP解析器都会忽略该声明，导致类被当成全局类处理。
- 错误示例：文件开头有空行、
<?php前有空格、或用了带BOM的编辑器保存 - 正确做法：用支持无BOM UTF-8的编辑器（如VS Code、PhpStorm），保存前检查文件头；可用
hexdump -C filename.php | head确认是否含EF BB BF - 验证方式：在文件中加
var_dump(__NAMESPACE__);，输出为空字符串说明声明未生效
命名空间与物理路径不匹配
PSR-4自动加载依赖“命名空间前缀 → 目录路径”的映射关系。如果类在src/Controllers/User.php，命名空间就必须是AppControllers，少一级或多一级都会断链。
- ThinkPHP等框架严格校验大小写：Linux服务器上
app/controller≠App/Controller - Composer autoload配置中，
"App\" : "src/"表示所有AppXxx类从src/Xxx.php加载，中间路径必须逐级对应 - 快速自查：运行
composer dump-autoload -o --verbose，看输出里是否列出了你的类路径
use语句使用不当
use只影响当前文件内的名称解析，它不导入类，只是创建别名。常见误区包括混淆相对引用、漏掉反斜杠、或在命名空间内误调全局类。
- 在
AppControllers命名空间下，想用stdClass必须写new stdClass()，写new stdClass()会去找AppControllersstdClass - use后不能跟同名类：比如当前文件已定义
class Log{}，就不能use MonologLogger as Log，会报致命错误 - 批量导入要加花括号：
use AppModels{User, Post};，漏掉花括号会被当成单个类名解析
自动加载未更新或配置失效
改了命名空间或新增了类文件，但没刷新自动加载映射，Composer就“看不见”新类。
- 每次调整
composer.json中的autoload配置后，必须运行composer dump-autoload - 开发中建议加
-o参数生成优化映射：composer dump-autoload -o - 若用自定义加载器（如手动require），需确保加载逻辑覆盖新路径；框架项目还要检查
config/app.php等配置文件是否覆盖了autoload规则 - 临时调试可用
class_exists('App\Controllers\UserController')验证类是否能被识别
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
