先确认模板引擎与版本
ThinkPHP 5 和 6 默认使用内置模板引擎，语法接近原生 PHP 加标签库。修改前先查看 config/template.php 或 config/view.php，确认 viewpath、viewsuffix 和后缀名。常见后缀是 .html，也有项目改为 .tpl。版本不同，标签写法有差异，比如 5.1 与 6.0 在变量输出、循环标签上基本一致，但引入文件的方式略有区别。
定位要修改的模板文件
模板通常放在 application/模块/view/控制器/方法.html，单应用模式则是 app/view/控制器/方法.html。如果找不到，检查是否使用了自定义视图目录。通过控制器里 fetch() 的返回值可以反推模板名，例如 return $this->fetch('edit'); 对应 edit.html。多模块项目要分清模块名，避免改错文件。
修改模板的常见操作
变量输出与默认值
模板中输出变量用 {$name}，带默认值写 {$name|default='未填写'}。若变量是数组，用 {$user.name} 或 {$user['name']}。修改时注意不要破坏原有标签闭合。
循环与判断
循环用 {volist name="list" id="item"}，判断用 {if condition="$item.status eq 1"}。新增字段时，先确认控制器是否已 assign 该字段，否则模板不会显示。
引入公共片段
头部、底部通常用 {include file="public/header" /}。修改公共片段会影响所有页面，建议先备份或复制一份再改。
修改后不生效怎么排查
第一，清除模板缓存。ThinkPHP 编译后的模板在 runtime/template 或 runtime/cache 下，手动删除该目录即可。第二，检查是否有 HTML 缓存或 CDN。第三，确认修改的文件路径与控制器实际加载的路径一致。第四，开启调试模式 app_debug => true，刷新页面看是否有报错。第五，若用了模板布局，改的是布局文件而不是具体模板。
安全与维护建议
不要直接在模板里写数据库查询或复杂逻辑，保持 MVC 分层。修改前用 Git 提交一次，方便对比回滚。公共模板改动要通知团队，避免样式冲突。正式环境关闭调试模式，防止暴露路径信息。
小结
ThinkPHP 模板修改的核心是：找对文件、写对标签、清掉缓存。掌握这三步，大多数“改了没反应”的问题都能解决。遇到复杂布局时，先理清 include 与 extend 的继承关系，再动手改。
