Twig 缓存必须显式配置 twig: cache: false 并启用 auto_reload: true 才真正关闭，仅设 debug=true 或 APP_ENV=dev 不足；需验证缓存目录不生成文件、debug:container 显示 cache => false 且响应含 Last-Modified 头。
改了 Twig 模板文件，刷新页面还是旧内容——不是浏览器没刷新，也不是代码没保存，而是 Symfony 3 的 Twig 缓存没真正关掉。仅设 debug=true 或依赖 APP_ENV=dev 完全不够，必须显式禁用缓存引擎并验证生效路径。
twig.cache: false 是唯一可靠关闭方式
Twig 缓存由 cache 配置项控制，它不是布尔开关，而是一个路径值。设为 null、~ 或留空，Symfony 会 fallback 到默认缓存目录（如 %kernel.cache_dir%/twig），实际仍启用磁盘缓存。
- 在
config/packages/twig.yaml或config/packages/dev/twig.yaml中，必须写死：twig: cache: false
- 不要用
cache: ""或cache: null，YAML 解析后它们等价于未设置，不生效 - 若项目有多个 Twig 实例（如邮件专用的
email_twig），每个都要单独配cache: false - 该配置优先级高于环境判断，能绕过所有默认行为
auto_reload: true 必须同时启用
即使 cache: false 生效，若 auto_reload 关闭，Twig 也不会监听文件变更，你改了模板也无反应——它会直接报错或返回上次成功编译的结果（可能已过期）。
- 检查配置中是否含
auto_reload: true（dev 环境下默认开启，但某些 IDE 模板或 Docker 配置可能覆盖） - 在
config/packages/twig.yaml里显式声明更稳妥：twig: cache: false auto_reload: true
- Windows 下注意杀毒软件或文件系统锁可能导致
filemtime()返回陈旧时间戳，误判“未修改” - PHPStorm 用户需关闭 Settings → Appearance & Behavior → System Settings → “Use safe write”，否则 Twig 监听不到原子保存事件
验证缓存是否真关闭了
别信“我删过 var/cache/dev/twig/”，要观察行为：关掉缓存后，该目录不该再生成任何 PHP 文件；且修改模板后无需清缓存即可立即生效。
- 手动删除
var/cache/dev/twig/目录（确保它不存在） - 修改任意一个
.twig文件并保存 - 刷新页面，立刻检查
var/cache/dev/twig/是否被重建 —— 若出现新 PHP 文件（如abc123.php），说明cache: false没生效或被其他配置覆盖 - 运行
php bin/console debug:container --parameter=twig.options，确认输出中"cache" => false（不是null、字符串路径或空数组） - 访问一个带 Profiler 的页面（如
/_profiler），用curl -I http://localhost/_profiler | grep Last-Modified，有该 header 才表示 Twig 正在监听文件变更
Docker / CI 环境容易漏掉的关键点
本地调通不代表协作环境一致。Docker 卷权限、CI 构建时的环境变量覆盖、甚至宿主机与容器时区不一致，都会让 auto_reload 失效或缓存“幽灵复活”。
- Docker 中确保
var/cache是可写卷，且挂载方式不屏蔽文件变更通知（避免用cached或delegated模式） - CI 脚本中加入断言：
php bin/console debug:container --parameter=twig.options 2>&1 | grep -q '\"cache\" => false' - 检查
.env文件是否被 CI 覆盖，确认APP_ENV=dev和APP_DEBUG=true同时生效 - 若用
php bin/console server:run，必须加--env=dev，否则 fallback 到 prod 模式，cache: true是硬编码逻辑
最麻烦的从来不是“怎么关”，而是有人改了 base.html.twig 却不知道队友的机器正从 var/cache/dev/twig/xxx.php 里读着一周前的编译结果。把 cache: false 写死、加 CI 断言、再定期检查 Last-Modified 响应头，比每次问“你清缓存了吗”实在得多。
