ThinkPHP模板缓存核心是预编译解析后的PHP代码为文件，后续请求直接include执行；需配置cache=>true、cache_path可写、慎用layout，并通过cache_prefix防冲突、{include cache}细化粒度、{nocache}排除动态内容。
ThinkPHP 生成模板缓存的核心在于让框架把解析后的 PHP 代码提前编译好、存成文件，后续请求直接 include 执行，跳过重复的模板语法分析和编译过程。这一步不是自动完成的，需要明确配置 + 正确路径 + 合理清理机制。
确认模板缓存已开启并指向有效路径
在 config/template.php 中检查以下配置项：
- 'cache' => true：必须为 true，否则整个模板缓存链路被禁用
- 'cache_path' => runtime_path('template')：确保路径存在且 Web 进程有读写权限（如 www-data 可写）
- 'layout_on' => false 或谨慎使用：开启 layout 会导致主模板+所有 include 文件绑定为一个缓存单元，任一变动即全失效；高频更新场景建议关闭或拆分缓存粒度
避免缓存冲突与失效异常
常见问题不是“没缓存”，而是缓存没生效或命中错误：
- cache_prefix 不要留空或设纯数字（如 '123'），推荐带项目标识的字符串，例如 'cache_prefix' => 'shop_v2_'
- 模板路径中避免中文、emoji、特殊符号，PHP 8.1+ 下哈希不稳定易导致缓存文件名错乱
- 若改了模板但页面未更新，先执行 var_dump(config('template.cache_path')) 确认实际写入位置，再手动清空对应目录
按需控制局部缓存行为
并非所有内容都适合全局缓存，灵活使用标签可提升命中率：
立即学习“PHP免费学习笔记（深入）”；
- 用 {include file="common/header" cache="3600"} 给稳定区块加独立缓存（单位：秒）
- 动态 include（如 {include file="$tpl_name"}）会跳过缓存，应改用固定路径或前端异步加载
- 临时绕过缓存：在模板开头加 {nocache}...{/nocache}，适用于用户信息、时间戳等实时内容
上线前必须执行的生成动作
开发时缓存是“边用边建”的，但生产环境要主动固化：
- 确保 APP_DEBUG=false 已生效（检查 var_dump(config('app_debug')) 输出 false）
- 运行命令：php think optimize:template —— 它会批量编译所有已加载过的模板，生成 .php 缓存文件到 cache_path 目录
- 该命令不自动触发，也不随部署脚本默认执行，必须人工或 CI/CD 显式加入
