ThinkPHP 6 的 make:controller 命令需手动安装扩展：TP6.0 安装 topthink/think-helper，TP6.1+ 默认集成但需确认 config/console.php 中已注册 think\command\MakeController；控制器名须按模块/类名格式（如 User/UserController），命名空间自动补全为 app\controller\User；模板可自定义 stubs/Controller.stub；生成后需手动配置路由且方法必须为 public。
thinkphp make:controller 命令不生效或报错
直接运行 php think make:controller 却提示 “Command ‘make:controller’ is not defined”？不是你输错了，是 ThinkPHP 6 默认没装命令行生成器扩展。这个命令不属于框架核心，得手动装 topthink/think-orm 之外的另一个包：topthink/think-helper（旧版 TP6.0.x）或更常见的——topthink/think-cli（TP6.1+ 推荐）。
- TP6.0：运行
composer require topthink/think-helper，再试命令 - TP6.1+：官方已把生成器整合进
topthink/framework本身，但需确认是否启用了think\command\MakeController命令类 —— 检查config/console.php中commands数组是否包含它（默认已配好，除非你删过） - 如果用的是 Laravel 风格的自定义命令目录，或重写了
Console类，make:controller可能被覆盖或未注册
控制器名传参格式和命名规范
命令后跟的控制器名不是随便写的字符串，ThinkPHP 会按规则自动补全命名空间、文件路径和类名。写错就生成到奇怪位置，甚至类名非法。
- 推荐写法：
php think make:controller User/UserController→ 生成app/controller/User/UserController.php，类名为UserController，完整命名空间是app\controller\User - 不能写成
UserController（缺模块路径），否则会生成到app/controller/UserController.php，且类名变成UserControllerController（框架自动加后缀） - 也不能写带后缀的
User/UserController.php，命令会把它当文件名拼进路径，导致嵌套错误 - 大小写敏感：Windows 下可能不报错，Linux/macOS 下路径找不到；建议全部小写模块名 + 驼峰控制器名（如
Api/ArticleController）
生成时指定模板或跳过方法骨架
默认生成的控制器带空的 index 方法和注释块，但实际项目中你可能只需要一个空壳，或者想用自定义模板（比如带权限检查的 base controller）。ThinkPHP 的 make:controller 不支持 --template 或 --stub 参数（那是 Laravel 的），它只认一个隐式逻辑：
- 它会尝试加载
think\command\stubs\Controller.stub模板文件，如果存在就用它；否则 fallback 到内置默认模板 - 想改模板？复制 vendor/topthink/framework/src/think/command/stubs/Controller.stub 到项目根目录下的
stubs/Controller.stub，然后修改内容（注意保留{%className%}、{%namespace%}这类占位符） - 不想生成任何方法？只能手动删掉 stub 里的
public function index()块，没有开关参数可关 - 生成时不加任何方法，不代表它“更轻量”——类文件体积差不了几行，重点是后续维护时别忘了补逻辑
生成后路由不识别或 404
生成完控制器，访问 /user 却报 404？不是命令问题，是路由没连上。ThinkPHP 默认关闭了「多应用模式下的自动路由」，而且控制器方法必须是 public 才能被访问。
立即学习“PHP免费学习笔记（深入）”；
- 确认当前是单应用模式（
app/middleware.php没启用多应用中间件），且config/route.php中'with_route' => true已开启 - 检查方法是否为
public function index()—— 如果手误写成protected或漏了public，请求直接拒绝 - URL 路径由「小写模块名/小写控制器名（不含 Controller 后缀）/方法名」组成，例如
User/UserController对应/user/index，不是/user/user/index - 如果用了路由分组或闭包路由，要手动绑定，命令生成的控制器不会自动注册路由
最常被忽略的一点：命令只管写文件，不管路由、中间件、依赖注入这些——它只是个代码搬运工，不是项目管家。
