ThinkPHP 8.0静态缓存通过生成静态HTML文件实现，需开启HTML_CACHE_ON、合理设置HTML_CACHE_TIME与HTML_CACHE_RULES，隔离缓存路径，避免session干扰和动态内容硬编码，并验证缓存命中与更新。
ThinkPHP 8.0 的静态缓存（HTML 缓存）不是靠 Redis 或路由缓存实现的，而是将动态页面输出直接写成静态 HTML 文件，下次请求直接读取该文件，跳过框架完整生命周期。要让它性能最好，关键不在“参数多”，而在精准控制缓存粒度、避免误击、确保可清除、不干扰其他缓存机制。
以下是你真正需要调的几项核心配置和实操要点：
HTML 缓存开关与基础时效
-
'HTML_CACHE_ON' => true：必须开启，否则不生成任何静态文件 -
'HTML_CACHE_TIME' => 3600：建议设为整数秒（如 1 小时），不要设为 0 或负数（会导致无限缓存，清不掉） -
'HTML_FILE_SUFFIX' => '.html'：保持默认即可，改后需同步调整 Nginx 静态规则，否则 404
缓存路径与命名要隔离、可定位
立即学习“PHP免费学习笔记（深入）”；
-
'HTML_CACHE_RULES' => [ '__default__' => ['status' => 1, 'time' => 3600] ]：按路由规则精细控制，比如只对/article/:id缓存 10 分钟，首页缓存 2 小时 -
'HTML_CACHE_PATH' => './runtime/html/'：建议单独建目录（如runtime/html/），别和cache/log/混在一起，便于运维清理或挂载只读卷 -
'HTML_CACHE_SUFFIX' => '.shtml'：可选，用非.html后缀能规避某些 CDN 对.html的强制压缩或重写行为
避免缓存污染与误命中
- 不要在启用 HTML 缓存的同时，在控制器里调用
session_start()、header()或输出任意内容（哪怕一个空格）——这会让框架自动跳过静态缓存写入 - 登录态、用户昵称、购物车数量等动态区块，必须用
{:widget('user_info')}或{:dynamic}标签包裹（需配合模板引擎动态解析），不能硬写进缓存 HTML 里 - 若页面含 AJAX 加载的用户数据，静态缓存只管骨架，这部分由前端独立请求，无需干预
上线前必须验证的三件事
- 访问目标 URL 一次，检查
runtime/html/下是否生成对应路径的.html文件（如/article/123.html） - 再次访问同一 URL，观察响应头中是否有
X-Thinking-Cache: HIT（TP8 自带标记，需开启调试或自定义中间件输出） - 修改对应控制器逻辑（比如 echo 'test';），刷新页面——如果内容没变，说明缓存生效；如果变了，说明没命中或被绕过
基本上就这些。它不复杂，但容易忽略 session 干扰和路径权限问题。真正影响性能的，从来不是 HTML_CACHE_TIME 多设了 100 秒，而是缓存生成失败却以为成功了。
