注释 twig.yaml 的 cache 配置无效,因 Twig 有默认缓存路径;必须显式设 cache: false(布尔值)并执行 cache:clear,同时禁用 OPcache 和检查子模板缓存。

Twig 模板缓存不能靠注释配置节点来关闭,那是无效操作;必须修改 twig.yaml 中的 cache 选项或设为 false,否则注释掉 cache: 行仍会走默认路径(通常是 %kernel.cache_dir%/twig)。
为什么注释 twig.yaml 的 cache 配置没用
Twig 在 Symfony 3 中的缓存行为由配置驱动,但不是“有就用、没就关”。即使你把 cache: 这行注释掉,框架仍会 fallback 到默认缓存目录——因为 cache 选项本身有默认值(true 或一个路径字符串),不显式设为 false 就不会禁用。
- 注释掉
# cache: '%kernel.cache_dir%/twig'→ Twig 仍会创建并使用默认缓存路径 - 写成
cache: false→ 才真正跳过编译缓存,每次请求都重新解析模板 - 写成
cache: null或空字符串 → 等同于未设置,依然走默认
开发环境关缓存的正确写法
在 config/packages/dev/twig.yaml 中,确保配置明确且生效:
twig:
cache: false
debug: true注意两点:
-
cache: false必须是布尔值false,不是字符串'false'或注释 - 该配置需放在
dev环境专属文件里(如dev/twig.yaml),避免误关生产环境缓存 - 改完后必须执行
php bin/console cache:clear --env=dev,否则旧缓存文件仍被加载
关了缓存但模板还是没更新?检查这三点
常见“关了缓存却看不到改动”的原因和对应动作:
- PHP OPcache 未禁用:Twig 编译后的 PHP 文件可能被 OPcache 缓存,开发时建议在
php.ini中设opcache.enable_cli=0并重启 Web 服务 - 浏览器缓存了响应:加个随机查询参数(如
?t==time()?>)或禁用浏览器缓存调试(Network → Disable cache) - 用了
include或render引入子模板:这些子模板各自独立缓存,需确认它们所在路径也受同一cache: false控制
最易被忽略的是 OPcache 和子模板缓存——哪怕 Twig 层关了,底层 PHP 字节码或嵌套模板仍可能返回旧内容。


















