模板源码的定位
ThinkPHP 的模板层并非简单文件包含。框架内置的模板引擎负责把含有特殊标签的 .html 文件，编译成可执行的 PHP 文件，再交给视图层渲染。源码集中在 think\template 目录，核心是 Template 类与驱动类 Think。
理解这条链路，才能定位“页面为什么没渲染”“标签为什么被转义”这类问题。
编译流程拆解
模板渲染大致经过四步：
- 读取模板文件：根据配置定位视图目录，支持多级主题。
- 标签解析：正则匹配
{volist}、{if}、{$var}等标签，替换为 PHP 语句。 - 生成编译文件：写入
runtime/temp缓存目录，避免重复解析。 - 执行编译结果：通过
include载入编译文件，输出内容。
缓存文件是性能关键。模板未修改时，框架直接复用编译结果，跳过解析阶段。
二次开发常改哪些点
自定义标签
在 config/template.php 中注册标签库，或继承 TagLib 类。每个标签对应一个方法，返回 PHP 代码字符串。注意转义与变量作用域，避免生成不安全代码。
修改分隔符
默认左定界符 {、右定界符 } 可配置。若前端使用 Vue 或 React，必须改分隔符，否则会与前端语法冲突。改完要清理编译缓存，否则旧文件仍按原规则解析。
视图驱动替换
ThinkPHP 支持更换模板驱动。若项目需要 Twig 或 Blade，可实现驱动接口，接管编译与渲染。但多数场景下，原生引擎已够用，替换成本主要在标签迁移。
常见坑与排查
- 缓存不更新：检查
runtime/temp权限与配置中的tpl_cache。 - 变量未定义：编译文件里会生成
isset判断，若关闭提示，会静默为空。 - 标签嵌套错误：正则解析对嵌套层级敏感，标签未闭合会导致整段被当作文本。
- XSS 风险：默认输出会转义，使用
raw或|raw需确认数据来源可信。
性能与安全建议
生产环境务必开启模板缓存，并锁定 runtime 目录写入权限。不要在生产环境开启模板调试模式，它会暴露编译路径与变量结构。若模板由用户上传，必须白名单过滤标签，防止任意 PHP 代码注入。
掌握模板源码的编译逻辑，比死记标签用法更有效。遇到渲染异常时，直接查看 runtime/temp 下的编译文件，多数问题一目了然。
