因为twig缓存与symfony debug模式独立，debug=true仅控制profiler等，不关闭twig磁盘缓存；必须显式配置twig: cache: false（yaml布尔值），并验证var/cache/dev/twig目录无新文件生成。
为什么 debug=true 但改了 .twig 文件还是不生效
因为 Twig 的缓存开关和 Symfony 的 debug 模式是两套独立机制。debug=true 只影响 Profiler、错误页面、容器热加载等，Twig 默认在 dev 环境下仍启用磁盘缓存——它会把 .twig 编译成 PHP 文件写入 var/cache/dev/twig/，后续请求直接 include 这些 PHP，跳过解析。你改了源文件，但引擎没重新读，自然不更新。
常见现象包括：保存后刷新页面无变化、var/cache/dev/twig/ 下持续生成新文件、甚至出现 file_put_contents(): Permission denied 报错（说明缓存路径不可写，但 Twig 仍试图写入）。
真正关闭 Twig 模板缓存的唯一可靠写法
必须在 config/packages/twig.yaml（或 app/config/config_dev.yml，Symfony 3 常用位置）中显式设置：
twig: cache: false
注意这不是字符串 "false"，而是 YAML 的布尔字面量 false。以下写法均无效：
-
cache: ~（会被 Symfony 合并为默认路径） -
cache: null或cache: "" -
cache: "%kernel.cache_dir%/twig"（路径存在即启用缓存）
若项目用了多个 Twig 实例（如邮件专用实例），每个都要单独配 cache: false。
验证是否真的关掉了缓存
别信“我改了配置就完了”。执行三步验证：
- 删掉
var/cache/dev/twig/整个目录 - 修改任一
.twig模板并保存 - 刷新页面，检查
var/cache/dev/twig/是否有新 PHP 文件生成
如果目录保持为空，说明 cache: false 生效；如果仍有文件写入，要么配置没加载（检查环境是否真为 dev），要么被其他配置覆盖（比如 config_prod.yml 里误写了 twig 配置并泄漏到 dev）。
额外注意：PHPStorm 的 “safe write” 功能会导致文件变更监听失败，建议在 IDE 设置中关闭该选项；Docker 环境需确保 var/cache 是可写 volume，且宿主机与容器时区一致，否则 filemtime() 判断可能出错。
auto_reload 不等于 cache: false，但它必须开着
auto_reload: true（默认已启用）的作用是让 Twig 在每次请求前检查模板文件的修改时间，决定是否重新编译。但它只在缓存启用时才有意义——如果 cache: false，Twig 根本不存编译结果，也就无所谓“重载”。
不过仍建议显式保留该配置：
- 避免某些自定义
Loader或Cache适配器绕过cache: false逻辑 - CI 流水线中可用
curl -sI /_profiler | grep Last-Modified断言响应头存在，证明文件监听链路正常 - 万一哪天临时切回缓存模式，不至于漏掉 reload 导致调试失效
最麻烦的情况不是配置不会写，而是有人改了模板却不知道队友的机器正从 var/cache/dev/twig/ 里读着一周前的编译结果。把 cache: false 写死、加 CI 检查、删缓存目录后看日志是否报 Twig\Error\LoaderError（说明真没走缓存），比问“你清缓存了吗”管用得多。
