namespace声明必须位于PHP文件最顶部且前面不能有任何输出，包括空格、BOM、echo或不可见字符；declare(strict_types=1)是唯一允许在namespace前的语句。
namespace 声明位置不对，文件开头有不可见字符
报错类似 Fatal error: Namespace declaration statement has to be the very first statement in the script，根本不是路径或大小写问题，而是 PHP 编译器直接拒识 namespace。ThinkPHP 5.0.21 对此极其敏感。
常见诱因：
- 文件用了 UTF-8 with BOM 编码，BOM 字节（
）藏在最前面，肉眼看不见 - 文件首行有空格、制表符或换行符（哪怕只多一个回车）
- 写了
declare(strict_types=1)但后面跟了空行，再写 namespace —— 这不行，必须紧挨着
实操建议：
- 用 VS Code 或 Sublime Text 打开文件，开启「显示空白字符」，确认第一行第一个字符就是
namespace - 另存为 UTF-8 无 BOM 格式（不要选“UTF-8”默认项，要明确勾选“无 BOM”）
- 删掉所有首行前的空行、空格，确保
namespace appcontroller;是文件第一行有效内容
命名空间与目录结构不匹配，PSR-4 加载失败
ThinkPHP 5.0.21 默认启用 Composer 的 PSR-4 自动加载，它不会扫描文件，只按 composer.json 里写的映射去查。你写了 namespace appcontroller;，它就只去 application/controller/（注意是 application，不是 app）找文件 —— 这是 TP5 和 TP6 最关键的区别。
立即学习“PHP免费学习笔记（深入）”；
典型错误现象：Class 'appcontrollerIndexController' not found，但文件明明在 application/controller/IndexController.php。
检查点：
- 确认
composer.json中 autoload 配置是"app\": "application/"（双反斜杠转义），不是"app": "app/"或漏掉末尾斜杠 - 文件路径必须是
application/controller/IndexController.php，不能是application/controllers/IndexController.php（多了 s） - Linux 服务器上，
IndexController.php和indexcontroller.php是两个文件；Windows 下不报错，部署后必崩
执行 composer dump-autoload -o 强制刷新映射，别跳过这步 —— ThinkPHP 不自己 reload 类路径。
use 语句写错，或动态类名没加反斜杠
报错不在声明处，而在 new 或调用时，比如 new User() 报 Class not found，但 User 类明明已 use AppModelsUser;。这不是 namespace 错，是 use 没生效或用法错。
关键细节：
-
use只是起别名，不触发自动加载；真正触发加载的是new User()或User::find()这种“使用”行为 - 动态实例化必须传全限定名字符串：
$class = 'App\Models\User'; new $class();—— 单反斜杠会解析失败，双反斜杠才对 - 调用全局函数如
date()或json_encode()时，如果当前命名空间下有同名函数，必须写date()，否则可能被覆盖
TP5.0.21 不支持 PHP 7.4+ 的多 namespace 块写法，一个文件只允许一个 namespace 声明，别混用 namespace { ... } 和 namespace AB { ... }。
继承基类时，父类 namespace 或路径错了
子控制器报 Class not found，但自己文件没问题 —— 很可能是它 extends 的基类（比如 CommonController）没加载成功。ThinkPHP 5.0.21 会先尝试加载父类，失败就直接终止，不会提示“父类找不到”，只报子类不存在。
排查顺序：
- 打开子控制器，看
extends CommonController，确认CommonController文件是否存在、路径是否在application/common/controller/等合理位置 - 检查该父类文件的
namespace是否匹配路径，例如application/common/controller/CommonController.php必须写namespace appcommoncontroller; - 如果父类用了自定义命名空间（如
namespace Common;），必须在composer.json中额外配置 PSR-4 映射，并重新dump-autoload
最容易被忽略的是：TP5.0.21 的 application 目录下没有默认的 common 模块，你手动建了 common 目录，却忘了配 autoload —— 此时父类永远加载失败，子类跟着一起挂。
