ThinkPHP控制器命名空间必须严格匹配目录结构并遵循PSR-4规范：命名空间路径等于目录相对路径，类名首字母大写且文件名与类名一致；子目录需逐级映射，大小写敏感，深层目录需在provider.php中显式绑定。
ThinkPHP控制器的命名空间必须严格匹配目录结构，且遵循PSR-4规范。核心原则是：命名空间路径 = 目录相对路径，类名首字母大写，文件名与类名完全一致。
标准命名空间格式
控制器放在 app/controller/ 目录下时，命名空间统一为 app\controller；若在子目录（如 app/controller/api/），则命名空间为 app\controller\api。
- ✅ 正确示例：
文件路径：app/controller/UserController.php
命名空间：namespace app\controller;
类名：class UserController - ✅ 带模块子目录示例：
文件路径：app/controller/admin/RoleController.php
命名空间：namespace app\controller\admin;
类名：class RoleController - ❌ 错误写法：
namespace app\controller\Admin（大小写不一致）
❌ 错误写法：namespace app\controller\admin\role（多了一级，实际目录只有 admin/RoleController.php）
命令行生成时的命名空间自动推导
使用 php think make:controller 时，框架会根据你输入的参数自动补全命名空间：
-
php think make:controller User/UserController→ 生成app/controller/User/UserController.php，命名空间为app\controller\User -
php think make:controller api/ArticleController→ 生成app/controller/api/ArticleController.php，命名空间为app\controller\api - ⚠️ 不要加
.php后缀或写成UserControllerController，否则命名空间和类名都会错乱
模块化项目中的命名空间变化
如果项目启用了多模块（如 app/index/controller/），命名空间需体现模块名：
立即学习“PHP免费学习笔记（深入）”；
- 文件路径：
app/index/controller/Index.php
命名空间：namespace app\index\controller;
类名：class Index - 注意：
app\index\controller是完整命名空间，不能简写为app\controller，否则自动加载失败 - 模块名、控制器目录名、命名空间层级三者必须一一对应，大小写也须完全一致（Linux/macOS 下敏感）
深层目录与自定义命名空间映射
当控制器路径过深（如 app/controller/v1/user/ProfileController.php），默认的 app\controller 映射无法覆盖三层以上结构：
- 框架只认
app\controller\Xxx这种两级命名空间，v1层会被误判为顶级命名空间 - 解决方式：在
app/provider.php中显式绑定子命名空间：Container::getInstance()->bind('app\controller\v1', app_path('controller/v1')); - 同时控制器内声明命名空间为：
namespace app\controller\v1\user;，确保与目录和绑定配置严格一致
