是Twig编译缓存未清理:Symfony 3 dev环境下Twig模板编译后存于var/cache/dev/twig/,改模板不自动重编译,需手动删除该目录或设twig.yaml中cache: false。

修改Twig模板后页面没变,是不是缓存没关?
不是“没关”,而是 Symfony 3 在 dev 环境下默认启用 Twig 编译缓存,但它的行为和你想象的不一样:它会把 Twig 模板编译成 PHP 文件存在 var/cache/dev/twig/ 下,只要文件没被删、PHP 进程没重启,改了 .html.twig 文件也不会重新编译——尤其在某些 Web 服务器(如 Apache prefork + mod_php)或 CLI 调用场景下,缓存进程可能长期存活。
- 别只清
cache:clear,它不自动删 Twig 编译缓存目录;必须手动删var/cache/dev/twig/或整个var/cache/dev/ - 确认当前环境确实是
dev:检查.env中APP_ENV=dev且APP_DEBUG=true,否则 Twig 会走生产模式缓存逻辑(更顽固) - 如果你用的是内置 Web Server(
php bin/console server:run),每次改完模板后需 Ctrl+C 停掉再重起,否则 PHP 进程复用旧编译结果 - 某些 IDE(如 PHPStorm)开启“File Watchers”时会自动刷新浏览器,但它不触发 Twig 重编译——得靠删缓存或重启服务
怎么让 Twig 模板改完立刻生效?
最稳的方式是关掉 Twig 编译缓存,只在开发时用。这不是性能倒退,而是避免误判问题根源。
- 在
config/packages/twig.yaml中显式设cache: false(注意不是注释掉,是明确赋值为false) - 如果用了自定义 Twig 环境(比如多模板引擎),确保该环境配置里也写了
cache: false - 删掉
var/cache/dev/后再访问一次页面,确认var/cache/dev/twig/下不再生成新文件 - 验证是否生效:改一行模板内容 → 刷新页面 → 看变化;再改一次 → 不刷新也能看到(说明真没缓存)
为什么清了 cache:clear 还不行?
cache:clear 命令主要清 Symfony 容器、路由、事件监听器等缓存,但 Twig 编译缓存是独立路径、独立生命周期的——它由 Twig 自己管理,Symfony 不介入清理。
-
cache:clear不碰var/cache/dev/twig/,哪怕你加了--no-warmup也没用 - 某些部署脚本或 CI 流程里会跳过
twig目录清理,导致本地改了模板却始终显示旧内容 - 如果你开了 OPCache(PHP 7.0+ 默认启用),它可能缓存了已编译的 Twig PHP 文件,此时要执行
opcache_reset()或重启 PHP-FPM - 浏览器也可能缓存了整页 HTML,按 Ctrl+F5 强刷,或临时禁用浏览器缓存(DevTools → Network → Disable cache)
模板缓存关了,但 layout.html.twig 还是不更新?
这时候大概率不是缓存问题,而是继承链或路径解析错了——Twig 的 {% extends %} 是静态解析的,写错路径不会报错,只会默默 fallback 到默认或旧版本。
- 检查
{% extends 'base.html.twig' %}中的路径是否拼写正确,大小写敏感(Linux/macOS 下尤其关键) - 确认你改的是真正被继承的那个文件:比如控制器指定了
template: 'user/index.html.twig',那它 extends 的才是 layout,不是你正在编辑的文件 - 用
php bin/console debug:twig查看 Twig 加载路径,确认templates/目录是否在paths列表里 - 如果用了
app/Resources/views/这种老式路径,要检查config/packages/twig.yaml是否还保留着旧配置:paths: ['%kernel.project_dir%/app/Resources/views']
var/cache/dev/twig/ 和 {% extends %} 的字符串。


















