模板编译缓存需手动启用，settemplatedir()后不生效是因未开启缓存开关；smarty需设caching常量、twig需配置cache目录；compile_id与cache_id不可混用；force_compile和auto_reload上线必须关闭。
模板编译缓存必须手动开启，setTemplateDir() 后不生效是常见错觉
PHP 模板引擎（如 Smarty、Twig）默认不会自动缓存编译后的 PHP 代码，哪怕你设了 setCompileDir()，也得显式启用缓存开关。很多人改完路径就以为万事大吉，结果每次请求还是重新解析 .tpl 文件。
-
isCached()和display()要配对用，单独调display()不走缓存逻辑 - Smarty 中必须设
$smarty->caching = Smarty::CACHING_LIVE;或SMARTY_CACHING_LIVE（注意不是布尔值true） - Twig 需明确传入
cache选项，比如new Twig_Environment($loader, ['cache' => '/path/to/cache'])，空字符串或false会禁用 - 目录权限不到位时，
file_put_contents()失败但无报错，建议加is_writable($compileDir)检查
缓存文件名冲突：compile_id 和 cache_id 别混用
模板编译结果按源文件路径 + compile_id 哈希生成，而运行时缓存（如 HTML 片段）靠 cache_id 区分。两者作用域不同，混着设会导致编译文件被覆盖或命中错误版本。
-
compile_id用于多环境隔离（如 dev/staging/prod），应设为常量字符串，比如'v2.4.1'；动态生成易引发重复编译 -
cache_id是运行时上下文标识，比如用户 ID 或 URL 参数哈希，不能用于控制编译行为 - Twig 中没有
compile_id概念，但cache目录结构本身依赖模板路径，所以别在不同项目共用同一缓存目录 - 修改模板后，旧编译文件不会自动清理，得靠
clearCompiledTemplates()或手动删.php文件
生产环境必须关掉 force_compile，否则缓存形同虚设
这个配置项在开发时方便调试，但上线后若仍为 true，引擎每次都会跳过缓存检查，直接重编译——性能损失比不用缓存还大，因为多了文件 I/O 和语法分析开销。
- Smarty 默认
$smarty->force_compile = false;，但很多项目在初始化时硬编码成true忘记切回 - Twig 的
auto_reload设为true时，会对比模板修改时间，有变动才重编译；生产环境应设false并配合部署时清缓存 - 检查方法：临时在模板里加个
var_dump(__FILE__);，刷新两次看路径是否一致；不一致说明还在重编译 - Apache + mod_php 下，OPcache 可能缓存编译后的 PHP 文件，但前提是
opcache.enable开启且opcache.validate_timestamps = 0（上线后）
模板继承与包含的路径解析影响缓存命中率
{include} 或 {extends} 里的相对路径，会被解析成绝对路径再参与哈希。路径写法稍有差异（比如 ./header.tpl vs header.tpl），就会生成两个不同的编译文件，浪费磁盘和 CPU。
- 统一用绝对路径引用，Smarty 推荐
{include file='common/header.tpl'}，避免../回溯 - Twig 中
{% include 'header.html.twig' %}的路径基于Twig_Loader_Filesystem注册的根目录，别在模板里拼接变量路径（如'blocks/' ~ type ~ '.html.twig'），那会彻底破坏缓存稳定性 - 如果用了自定义 loader，确保
getCacheKey()方法返回稳定值，否则引擎无法判断是否已编译过 - 符号链接目录下，
realpath()行为可能不一致，建议部署时用真实路径，别依赖软链
/tmp 不可写但日志没暴露出来。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
