tp6模板不渲染主因是扩展缺失或配置错误：必须执行composer require topthink/think-view，确保config/app.php中'default_return_type'=>'html'、config/view.php中'type'=>'think'，且app()->has('view')返回true；路径、变量名大小写、标签闭合及语言包加载均需严格匹配规范。
TP6模板引擎报错，多数不是语法写错了，而是底层没跑通——模板根本没被解析、语言包压根没加载、扩展包缺失或配置错位。先确认“能不能跑”，再查“哪里写错”。
模板压根不渲染？先装扩展、配对驱动
TP6默认不带模板引擎，view()调用会静默失败或返回空内容。必须执行：
- 安装扩展：
composer require topthink/think-view - 检查配置：
config/app.php中'default_return_type' => 'html' - 确认驱动类型：
config/view.php里'type' => 'Think'（不能是'php'，否则框架语法如{volist}不生效） - 运行
app()->has('view')，返回true才算真正就绪
变量显示为空？路径、命名、大小写全要对得上
TP6按约定路径找模板，变量也严格区分作用域和格式：
- 视图文件路径必须是
app/view/控制器名/方法名.html（如IndexController@index→app/view/index/index.html） - 传参必须显式：
return view('index', ['user_name' => '张三'])，只写view('index')不传数据，模板里{$user_name}就是空 - 模板中变量名大小写必须与数组键完全一致：
['UserName' => 'Tom']→ 只能用{$UserName}，{$username}无效 - 对象属性和数组用点号访问：
{$user.name}、{$list.0.title}，不支持{$user->name}
标签编译失败？重点查嵌套与闭合
报Template compile error或unexpected '{'，说明模板在转成PHP代码时卡住了：
- 所有标签必须成对：
{if}{/if}、{volist name="list" id="vo"}{/volist}，漏一个{/xxx}就编译失败 - 禁止在标签内写原生PHP：
{php}echo $a;{/php}已被废弃，会破坏解析；改用{$a}或{:function()}（但注意：TP6已移除{:xxx}执行能力，仅作字符串输出） -
{switch}内部不能直接嵌套{volist}，会静默跳过；需改用{foreach}或拆分逻辑 - 删掉
runtime/view/目录，清除旧缓存后再试——编译失败的临时文件可能残留干扰
lang()不翻译、只输出键名？不是模板问题，是语言链断了
模板里lang('welcome')显示welcome，90%是因为语言包根本没加载成功：
- 先在控制器里硬测：
dump(lang('welcome'))和dump(file_exists(app()->getLangPath().'zh-cn.php')) - 语言文件必须是
app/lang/zh-cn.php（小写+短横线），不能是zh_CN.php或zh-cn/index.php - 文件开头不能有BOM、空格、注释或
echo，必须以<?php return ['welcome' => '欢迎'];结尾 - 确认
app/middleware.php中启用了think\middleware\LoadLangPack::class - 模板后缀必须是
.html或.php（.html需依赖think-view解析），.htm等不识别
