必须显式设cache: false，Twig缓存与Symfony debug模式独立；在config/packages/twig.yaml中硬编码twig: cache: false（YAML字面量），禁用safe write、加CI断言、每个Twig实例单独配置。
必须显式设 cache: false，仅开 debug: true 不起作用。 Twig 的缓存开关和 Symfony 的 debug 模式是两套独立机制，很多人改了模板没反应，就是卡在这一步。
怎么在 config/packages/twig.yaml 中真正关掉缓存
打开 config/packages/twig.yaml，确保包含这一行（不是注释、不是留空、不是设成 ~ 或字符串）：
twig:
cache: false
其他配置如 debug、auto_reload 可保持默认（它们通常已由环境自动设为 true），但 cache 这一项必须硬编码为 YAML 字面量 false。常见错误包括：
- 写成
cache: "false"（字符串，Twig 当路径处理） - 写成
cache: ~或直接删掉该行（Symfony 会 fallback 到默认缓存路径） - 在
config_dev.yml里配了，但主配置文件又通过imports覆盖了它
验证是否生效的三个实操动作
别只看页面刷新——得检查底层行为：
- 删掉
var/cache/dev/twig/目录，改一个.twig文件并保存，刷新页面；如果该目录始终为空，说明cache: false生效了 - 用
php bin/console debug:container --parameter=twig.options查输出，确认cache值是false（不是路径、不是null） - 访问任意模板渲染页，用
curl -I http://localhost:8000/some-route | grep Last-Modified；若返回头含Last-Modified，说明auto_reload: true正在工作，Twig 确实在监听文件变更
Windows / Docker / IDE 下容易踩的坑
这些环境会让“关缓存”变得不可靠：
- PHPStorm 默认开启 “safe write”，保存时先写临时文件再替换，Twig 监听不到变更 → 关掉设置里的
Use "safe write" - Docker 容器中
var/cache卷权限不对，或宿主机与容器时区不同，导致filemtime()返回异常时间 → 检查ls -l var/cache和date输出 - Windows 长路径或杀毒软件锁定
var/cache/dev/twig/→ 临时改用cache: /tmp/twig-cache测试，排除路径问题 - 用了自定义 Twig 实例（比如发邮件单独配了个
email_twig），必须对每个实例单独设cache: false
真正麻烦的不是配不配得上，而是改完模板后你信了“它应该生效”，结果队友机器上还在读 var/cache/dev/twig/abc123.php。把 cache: false 写死、加 CI 断言、禁用 safe write —— 这三步做完，才能放心双击保存就刷新。
