cache: false是唯一真正禁用Twig模板缓存的方式，必须使用YAML布尔字面量（非字符串、非null、非注释），且需配合auto_reload: true确保文件变更实时生效；多实例需逐一配置，CI中须断言参数值与响应头验证。
twig.cache: false 是唯一生效的关闭方式
设成 null、~、空字符串或注释掉配置，Twig 都会回退到默认路径（如 %kernel.cache_dir%/twig），实际仍启用磁盘缓存。只有 YAML 字面量 false 才能真正禁用缓存引擎——它会让 Twig 使用 NullAdapter，跳过所有写入逻辑。
必须写在 config/packages/twig.yaml 或 config/config_dev.yml 中，且优先级高于环境自动推导：
-
cache: false（✅ 正确，YAML 布尔字面量） -
cache: "false"（❌ 字符串，被当路径处理） -
cache: ~（❌ 空值，合并为默认路径） -
# cache: ...（❌ 注释，等同于未配置）
若项目有多个 Twig 实例（如邮件模板单独配了 email_twig），每个都要单独加 cache: false。
auto_reload: true 必须显式确认开启
关掉缓存只是第一步；auto_reload: true 才决定 Twig 是否每次请求都检查 .twig 文件修改时间。它默认开启，但可能被覆盖或误关。
验证方法：改一个模板后刷新页面，同时运行 ls -la var/cache/dev/twig/ —— 如果目录为空且无新文件生成，说明 cache: false 生效；但如果页面没反应，大概率是 auto_reload 没起作用。
常见干扰项：
- IDE “safe write” 功能（如 PHPStorm 默认开启）：先写临时文件再原子替换，导致
filemtime()拿到旧时间 → 关掉 IDE 的 safe write - Docker 容器与宿主机时区不一致：
filemtime()返回时间戳错位，缓存误判未更新 → 统一时区或挂载/etc/timezone - Windows 杀毒软件锁定
var/cache/dev/twig/目录 → 临时禁用实时防护或加白名单
CI/CD 中必须断言 cache 值为 false
本地配对了不等于团队一致。有人提交了 config_dev.yml 却忘了加 cache: false，或 CI 构建时用了错误的 APP_ENV，都会让缓存悄悄启用。
CI 脚本里应加入两条硬性检查：
- 执行
php bin/console debug:container --parameter=twig.options，grep 输出中"cache" => false（注意是 PHPfalse，不是null或字符串） - 用
curl -sI http://localhost/_profiler | grep Last-Modified，必须返回非空 —— 缺失该头说明auto_reload未生效或缓存未真正关闭
这两条比“清缓存”“重启服务”更可靠，因为它们验证的是运行时真实状态，而非操作动作。
关掉模板缓存后性能下降是预期行为
每次请求都重新解析、词法分析、编译 .twig 文件，必然带来开销。这不是配置错误，而是调试阶段的合理代价。
如果你发现响应明显变慢（比如首字节超 300ms），先排除其他因素：
- 是否同时开了 Xdebug？它会让 Twig 解析慢数倍 → 临时关掉
xdebug.mode=off - 模板是否包含大量嵌套
{% include %}或递归{% for %}？关缓存后这些开销全暴露出来 → 用 Profiler 查看 Twig 渲染耗时占比 - 是否误把
cache: false提交到了 prod 环境？生产环境必须用cache: "%kernel.cache_dir%/twig"并预热
真正容易被忽略的是：缓存开关和 auto_reload 是两个独立开关，缺一不可；而 cache: false 在 prod 下绝对不能出现 —— 它不会报错，但会让整个站点失去模板性能保障。
