页面样式错乱、布局塌陷、变量不渲染，说明模板缓存未清至runtime/view/目录，或新编译因语法错误（如标签不成对、{literal}嵌套、自定义标签未注册）失败；需彻底删除runtime/view/、关闭模板缓存定位问题、修复语法后再启用cache_time=>0自动更新。
ThinkPHP模板编译缓存清理后页面样式错乱、布局塌陷、变量不渲染，说明旧缓存虽已清除，但新编译过程被干扰或未完整生效，不是单纯“清得不够”，而是缓存重建路径出了问题。
确认是否真清干净了
只删了 Runtime/Cache 目录？那根本没动到模板缓存——它在 Runtime/View 下。ThinkPHP 模板引擎编译后的 PHP 文件全存在这里，路径按模板名哈希分散在多层子目录中。
执行命令：rm -rf runtime/view/（Linux/macOS）或 rd /s /q runtime\view（Windows CMD），必须删整个目录，不能只删 .php 文件或某一层子目录。
注意：如果 Web 服务器用户（如 www-data）和 CLI 执行用户不一致，删完可能因权限导致下次无法写入，建议统一用 Web 用户执行清理命令。
立即学习“PHP免费学习笔记（深入）”；
检查模板文件是否被意外破坏
清理后首次访问页面时，框架会重新解析模板并生成新的编译文件。若此时原始模板（如 index.html）本身有语法错误，就会卡在编译环节，生成的 .tpl.php 文件内容不全甚至为空。
打开报错页面对应的实际模板文件，重点检查：
- {volist} / {/volist}、{if} / {/if} 是否严格成对，中间有没有混入未转义的
{或}； - 是否误写了未注册的自定义标签，比如
{my:header}却没在app/taglib/下定义对应类； - 是否在 {literal} 块里又嵌套了 ThinkPHP 标签——这会导致整块被原样输出，变量失效。
强制触发模板重编译
第一步：进入 config/template.php，把 'cache' => true 临时改为 'cache' => false，保存。
第二步：刷新页面，此时模板不再走缓存，直接解析源文件，能立刻暴露语法问题。
第三步：修复所有报错后，再把 'cache' => false 改回 true，并确保 'cache_time' => 0 —— 这表示缓存永不过期，但每次都会比对源文件修改时间，有改动就自动重编译。
静态资源缓存干扰
样式乱了，但 HTML 结构正常？很可能是 CSS/JS 文件还在浏览器或 Nginx 缓存里，加载的是旧版本。
ThinkPHP 模板中应使用带哈希后缀的静态资源引用：<link rel="stylesheet" href="/static/css/app_{$css_hash}.css">。若你手动改了 CSS 却没更新 $css_hash 值，浏览器就永远拉不到新样式。
开发阶段可临时禁用 Nginx 静态资源长缓存：
注释掉配置中 expires 1y 和 add_header Cache-Control "public, immutable" 这两行，重启 Nginx。
检查字体与 PDF 模板是否连带异常
如果乱码出现在导出的 PDF 中（比如中文显示为方块），不是模板缓存问题，而是 mPDF 字体配置失效。清理 runtime/view 对 PDF 渲染无影响。
确认 config/mpdf.php 中 fontDir 指向真实可读路径（如 public/fonts/），且 fontData 内明确注册了 Noto Sans CJK SC 并启用 useOTL 和 useKashida。
HTML 模板中禁止使用 <style>body{font-family:"Microsoft YaHei"}</style>，mpdf 不识别 CSS font-family 回退链，只认你 fontData 里注册的字体名。
