ThinkPHP 8 初始化失败需手动运行 php think build；路由不生效因多应用模式需确认应用名匹配；Db::select() 返回空因严格字段检查，可临时关闭 strict 或显式指定字段；模板无法调用 config() 因函数未白名单，需在配置中添加 function_replace 或控制器赋值。
ThinkPHP 8 的 think 命令初始化失败怎么办
新装 ThinkPHP 8 后执行 php think 报错“Class 'think\Console' not found”，大概率是没跑安装脚本。Composer 安装后不会自动执行 think 命令的引导逻辑，必须手动触发一次初始化。
- 先确认已执行
composer create-project topthink/think（不是composer require） - 进入项目根目录后，立刻运行
php think build—— 这会生成app目录结构和基础控制器 - 如果提示
Command "build" is not defined，说明vendor/autoload.php没被正确加载，检查think文件头部是否包含require __DIR__ . '/vendor/autoload.php'; - Windows 下若报编码错误，把终端改为 UTF-8（PowerShell 中用
$OutputEncoding = [console]::InputEncoding = [console]::OutputEncoding = New-Object System.Text.UTF8Encoding）
路由定义写在 app/route/app.php 却不生效
ThinkPHP 8 默认启用「多应用模式」，app/route/app.php 只对名为 app 的应用生效；如果你没显式声明应用名，实际走的是 app/route/ 下的 app.php，但入口文件没加载它。
- 检查
public/index.php中是否调用了App::routeLoad(true)（新版默认开启） - 确认当前请求 URL 对应的应用名：比如访问
/index/hello，默认会匹配app应用，对应路由文件就是app/route/app.php - 如果想全局统一管理路由，改用
app/route.php（单应用模式），并在public/index.php中把App::useAppMulti(false)设为false -
Route::get('hello', 'index/hello')中的index/hello是控制器/方法名，不是路径；若控制器在app/controller/Index.php，方法叫hello，才对得上
Db::table('user')->select() 返回空数组但数据库明明有数据
ThinkPHP 8 默认开启「严格字段检查」，如果数据库表字段没在模型或查询中显式声明，select() 会过滤掉整行——不是报错，而是静默丢弃。
- 先执行
Db::table('user')->fetchSql(true)->select()，看生成的 SQL 是否合法，有没有被加了WHERE 1=0这类异常条件 - 检查
config/database.php中'strict' => true，临时设为false测试是否恢复数据；确认是字段问题后，再用->field('*')或->withoutField(false)显式放开 - 如果用的是 MySQL 8+，注意默认时区配置；
datetime字段在 PHP 里可能因时区转换变成null，导致字段校验失败 - 别直接在
Db::链式调用里嵌套变量，比如->where('id', $id ?? 0)，空值会被转成0导致查不到；改用->when($id, function ($query, $id) { return $query->where('id', $id); })
模板里 {:config('app.app_name')} 渲染不出内容
ThinkPHP 8 模板引擎默认关闭了函数调用能力，{:...} 语法只允许极少数白名单函数（如 date、nl2br），config() 不在其中。
立即学习“PHP免费学习笔记（深入）”；
- 最稳的方式是在控制器里把配置提前赋值：
$this->assign('app_name', config('app.app_name'));，模板里用{$app_name} - 如果坚持要在模板调用，需在
config/template.php中添加：'function_replace' => ['config' => '\think\facade\Config::get']，然后才能用{:config('app.app_name')} - 注意
config()是 Facade，不是全局函数；模板中不能写{:think\facade\Config::get('app.app_name')}，会解析失败 - 开发阶段可临时开启调试模式，在
config/app.php中设'debug' => true，这样模板报错会显示具体哪行被拦截
ThinkPHP 的“约定大于配置”在初期省事，但一旦某个环节没踩准约定（比如应用名、目录命名、时区、模板函数白名单），就会卡在看似无错实则无声的地方。盯住 config/ 和 app/route/ 这两个目录，比翻文档更快定位问题。
