ThinkPHP 6控制器文件名与类名必须严格一致且首字母大写、不带Controller后缀，如User.php对应class User；须继承BaseController才能使用assign()等方法；URL参数需依赖注入、开启自动绑定或显式路由配置。
ThinkPHP控制器文件名和类名必须严格匹配
ThinkPHP 6 要求控制器类名与文件名完全一致，且首字母大写、不带 Controller 后缀（但类名本身要带）。比如想访问 http://site.com/index/user/login，对应控制器文件路径是 app/controller/User.php，类名必须是 User，不能是 UserController 或 user。
常见错误现象：ClassNotFoundException 报错，提示找不到 app\controller\User 类；或者路由能进但方法调用失败，实际是自动加载器没找到类。
- 文件路径必须是
app/controller/XXX.php（TP6 默认命名空间是app\controller） - 类定义必须是
class XXX extends BaseController，不能写成class XXXController - 如果用了多应用模式，路径会变成
app/index/controller/XXX.php，命名空间也得同步改成app\index\controller
控制器方法默认必须是 public 且不能带参数（除非显式绑定）
ThinkPHP 的 URL 访问机制默认只支持无参的 public 方法。例如 public function login() 可以通过 /user/login 访问；但 public function detail($id) 直接访问 /user/detail/123 会报错或参数为空——这不是 bug，是框架默认不自动解析 URL 参数到方法形参。
使用场景：你希望用 /user/detail/123 传参，而不是写成 ?id=123。
立即学习“PHP免费学习笔记（深入）”；
- 方案一：用依赖注入，在方法签名里写
public function detail(\think\Request $request)，再手动取$request->param('id') - 方案二：启用方法参数自动绑定，在
config/route.php中设置'url_param_type' => 1，并确保路由规则允许（推荐配合 route 注册） - 方案三：显式定义路由，如
Route::get('user/detail/:id', 'User/detail')->option(['merge_param' => true])
继承 BaseController 才能用 $this->assign() 和模板渲染
很多新手直接写 class User 然后在方法里调用 $this->assign()，结果报 Call to undefined method。这是因为 assign()、fetch()、redirect() 这些快捷方法只在 think\Controller 或其子类（如 TP6 默认的 app\BaseController）中可用。
性能影响：不继承 BaseController 就无法使用内置视图集成，只能手动引入 View 类，代码冗余且易出错。
- 必须让控制器类继承
app\BaseController（TP6 推荐）或\think\Controller（兼容写法） - 如果自定义了
app\BaseController，记得检查它是否已正确继承\think\Controller -
$this->fetch()默认找的是view/user/login.html（小写+下划线转短横线），不是User.php同名模板
命令行创建控制器最不容易出错
手写控制器容易漏掉命名空间、继承、use 引入，尤其在多应用或模块化项目里。ThinkPHP 自带的 php think make:controller 命令能生成结构正确的骨架。
示例：php think make:controller index/User 会生成 app/index/controller/User.php，含标准命名空间、继承和空方法。
- 路径参数带斜杠表示层级，
index/User≠User，后者默认在根 controller 目录 - 加
--plain参数可跳过继承BaseController（极少需要） - 别用 IDE 自动补全生成类——它不知道 TP 的命名约定，常把类名补成
UserController
最容易被忽略的是路由与控制器的耦合关系：即使控制器文件存在、类能加载，如果没配路由或路由规则不匹配，照样 404。调试时先确认 php think route:list 是否列出目标路由，再查控制器定义。
