ThinkPHP命令行工具需在项目根目录（含think文件及app、config目录）运行；5.1+版用think或think.bat，6.x统一用php think；常见问题包括路径错误、autoload未加载、权限不足、命名空间不匹配及缓存未清理。
ThinkPHP命令行工具在哪儿启动
不是所有 ThinkPHP 项目默认支持 php think，得先确认你的入口是否存在。5.1+ 版本自带 think 可执行文件（Linux/macOS）或 think.bat（Windows），放在项目根目录；6.x 则统一用 php think，但前提是 think 文件可执行且 PHP 能识别当前目录下的 autoload。
常见错误现象：Command "xxx" is not defined. 或直接报 php: command not found —— 很可能没进对目录，或者没装好 Composer 自动加载。
- 必须在项目根目录下运行，即包含
think、app、config的那个目录 - Windows 用户如果双击
think.bat没反应，就老实用命令行：进入目录后执行php think - 若提示
Class 'think\Console' not found，说明框架核心未加载，检查vendor/autoload.php是否被正确引入，或运行过composer install
php think make:controller 不生成文件？
这是最常卡住的点：命令看似执行成功，但目录里啥都没多出来。根本原因通常是命名空间路径映射没对上，或者控制器目录权限/自动加载缓存干扰了生成逻辑。
使用场景：快速建一个带 CRUD 方法的控制器，比如管理后台的用户模块。
立即学习“PHP免费学习笔记（深入）”；
- 确保
app/controller/目录存在且可写（尤其 Linux 服务器上容易因权限拒绝创建） - 命令里的类名要符合 PSR-4 规范，例如
php think make:controller Admin/UserController会尝试生成app/controller/Admin/UserController.php，中间的/对应子目录 - 5.1 中该命令默认不加
--plain会继承BaseController，但如果你删了app/controller/BaseController.php，就会静默失败（无报错但不生成） - 运行完建议清一次配置缓存：
php think clear --config，否则某些版本下新类可能不被识别
为什么 php think optimize:schema 报错 Class not found
这个命令本质是把数据库表结构缓存成 PHP 数组，提升模型字段解析速度。但它依赖 think\Model 和数据库连接配置，一旦环境没配好，就直接崩在类加载环节。
性能影响明显：开启 schema 缓存后，Model::getSchema() 调用快 3–5 倍，但开发阶段几乎没必要常开。
- 先确认
database.php配置中'hostname'、'database'、'username'全都填对了，且数据库服务正在运行 - 如果用的是 MySQL 8+，注意默认认证插件是
caching_sha2_password，旧版 PDO 可能连不上，需改用mysql_native_password - 报
Class 'think\db\Connection' not found？说明框架 DB 组件没加载，检查config/database.php是否被正确 require，或是否误删了vendor/topthink/think-orm - 生成的缓存文件在
runtime/schema/下，别手动改它——下次运行命令会覆盖
自定义命令怎么注册到 php think 列表里
ThinkPHP 的命令行扩展靠 command 配置项注入，不是扔进某个目录就自动出现。漏掉注册这步，php think list 里永远看不到你的命令。
使用场景：给运维加个一键清理日志的 php think clean:logs，或定时任务前校验配置的 php think check:env。
- 命令类必须继承
think\console\Command，且实现configure()和execute()方法 - 在
app/command.php（5.1）或config/console.php（6.x）里注册，格式是'clean:logs' => app\command\CleanLogs::class - 类文件路径必须和命名空间严格一致，比如
app\command\CleanLogs就得放在app/command/CleanLogs.php - 修改完配置后，别忘了清控制台缓存：
php think clear --console，否则新命令不会出现在php think list里
命令行工具看着简单，实际每一步都卡在环境、路径、命名空间、缓存四者咬合上。最常被忽略的是：你以为在项目根目录，其实终端还停在上一级；你以为类名随便写，其实框架按 PSR-4 硬匹配；你以为命令跑完了，其实缓存没清导致后续全失效。
