twig.cache: false是唯一可靠关闭方式;设为null、~或空值会回退至默认路径,缓存仍生效;多twig实例需各自配置,且须配合auto_reload: true确保实时刷新。

twig.cache: false 是唯一生效的关闭方式
设 cache: null、cache: ~ 或留空,Symfony 会 fallback 到默认路径(如 var/cache/dev/twig/),缓存照常工作;只有明确写 cache: false 才真正禁用编译缓存。这个值是 YAML 字面量 false,不是字符串 "false",否则会被当路径解析。
如果你用了多个 Twig 实例(比如一个用于页面,一个用于邮件),每个都要单独配 cache: false,共用配置不继承。
-
config/packages/twig.yaml中直接改:twig: cache: false
- 若项目仍用旧式
app/config/config_dev.yml,则在该文件中覆盖:twig: cache: false
- 别用
cache: "%kernel.cache_dir%/twig"—— 这个路径总存在,等于没关
必须同时确认 auto_reload: true
关缓存只是让 Twig 不再写 PHP 文件,但模板是否“改保存就刷新”,取决于 auto_reload。它控制 Twig 是否每次请求都检查 .twig 文件的 filemtime()。默认为 true,但某些自定义环境或 Docker 配置可能覆盖它。
- 运行
php bin/console debug:container --parameter=twig.options,检查输出里auto_reload是否为true - Windows 下杀毒软件或 IDE 的“safe write”可能让
filemtime()滞后,导致 reload 失效 —— PHPStorm 中需关闭 System Settings → Use "safe write" - Docker 环境务必保证宿主机与容器时区一致,否则
filemtime()判断出错,Twig 认为模板“没更新”
验证缓存是否真关了
别信“我改了,也刷新了,应该好了”。真实关掉的表现是:var/cache/dev/twig/ 目录不再生成任何 PHP 文件,且删掉它后也不再自动重建。
- 手动删掉
var/cache/dev/twig/ - 改一个模板(比如加个
{{ dump() }})并保存 - 刷新页面,立刻检查该目录 —— 如果没新文件,说明关成功了;如果有,说明配置没生效或被其他地方覆盖
- 顺手跑一次
php bin/console cache:clear --env=dev,排除旧缓存干扰
CI/CD 中必须断言 cache 值为 false
本地关了不等于队友或 CI 也关了。协作项目里最麻烦的是:你看到的 HTML 是自己机器上刚编译的,而 CI 构建时用的是缓存里的旧 PHP 文件,结果测试通过但线上炸了。
在 CI 脚本里加两行硬性检查:
php bin/console debug:container --parameter=twig.options 2>&1 | grep -q \"'cache' => false\"- 对任意带模板渲染的路由发请求,检查响应头:
curl -s -I http://localhost:8000/_profiler | grep -q "Last-Modified"—— 缺失这个 header 就代表auto_reload没起作用或缓存没关
这些检查比口头约定“记得关缓存”可靠得多。真正难的不是操作,而是让所有人同一时刻面对同一份缓存状态。











