TP5.1将模板后缀设为.html报错的核心原因是框架未正确启用模板引擎或模板内容违反解析规则；需确认view.type为'Think'、view_suffix为'html'、禁用原生PHP代码、清除runtime/view与temp缓存，并确保变量输出为字符串或使用|raw过滤。
TP5.1 将模板后缀设为 .html 后解析报错，核心问题不在后缀本身，而在于框架对 HTML 文件的默认处理逻辑与模板语法冲突。ThinkPHP 5.1 的模板引擎默认支持 .html 后缀，但需满足三个前提：文件内容是合法模板语法、未混入原生 PHP 代码、且未被 Web 服务器或框架误判为静态资源。
确认模板文件未被当作纯静态 HTML 处理
如果模板里写了 {volist name="list"}{$vo.name}{/volist} 却直接输出原样标签，说明框架根本没走模板编译流程——大概率是路由或视图配置跳过了模板引擎。
- 检查
config/view.php中'type'是否正确设为'Think'（首字母大写），写成'think'或'php'会导致引擎不启用 - 确认
'view_suffix'确实设为'html'，且该配置在view配置项下生效，不是写在template或其他位置 - Windows 下注意路径分隔符，
'view_path'若用../template/类似写法，需确保实际目录存在且大小写完全匹配（Linux 严格区分）
禁止在 .html 模板中写原生 PHP 代码
TP5.1 默认禁用模板中的 <?php ?>，哪怕只是 <?php echo $name; ?>，也会导致解析中断或空白输出。
- 所有逻辑必须用 ThinkPHP 模板标签：
{$name}、{if $name}xxx{/if}、{:func($arg)} - 若需调用自定义函数，必须先在
config/template.php的'function'数组中注册，不能直接写<?php ?> - HTML 注释内不可包裹模板标签，例如
<!-- {if $a}xxx{/if} -->会破坏解析器状态，引发“Tag not closed”类错误
清理并锁定模板缓存行为
改了后缀后旧缓存仍可能指向 .php 编译文件，导致引擎尝试加载不存在的文件或复用错误结构。
立即学习“前端免费学习笔记（深入）”；
- 必须清空
runtime/view/和runtime/temp/两个目录（只清Cache不够） - 开发阶段建议临时关闭模板缓存：
'cache' => false，避免因缓存延迟掩盖配置问题 - 检查
runtime/view/下是否生成了以哈希命名的.php文件，若没有，说明模板根本没进入编译流程，应回头查view_path和路由是否命中正确控制器
验证变量输出是否触发转义异常
HTML 模板中直接输出数组或对象（如 {$data}）会触发 htmlentities() 报错：“expects parameter 1 to be string, array given”。
- 输出前确保变量是字符串，或用
|raw显式绕过转义：{$data|raw} - 若需传 JSON 到前端，PHP 层先
$this->assign('json_data', json_encode($arr));，模板中写JSON.parse('{$json_data|raw}') - 避免在
{$var}后紧跟 HTML 属性引号，如<div id="{$id}">，若$id为空或含双引号，会破坏 HTML 结构
