模板不更新是因为 Symfony dev 环境默认启用 Twig 编译缓存，即使 debug=true，只要缓存目录可写，Twig 就复用编译后的 PHP 文件；需显式设 twig: cache: false、清空 var/cache/dev/twig/ 并确保文件 mtime 正确。
模板不更新，不是缓存“没关”，而是 Symfony 默认在 dev 环境下仍会复用 Twig 编译缓存——哪怕你设了 debug=true，只要缓存目录可写，Twig 就会把模板编译成 PHP 文件并复用。
为什么改了模板却看不到效果
Twig 编译缓存（var/cache/dev/twig/ 下的 PHP 文件）一旦生成，就不会自动重编译，除非：文件修改时间戳被识别、缓存被清空、或 Twig 配置强制禁用缓存。开发时依赖“改完立刻生效”，但 Symfony 3 的 Twig 默认仍启用编译缓存，只是 debug 模式下会做时间戳检查——而某些 IDE 或部署方式（如 rsync 覆盖）可能不保留 mtime，导致 Twig 认为“没变”。
关闭 Twig 编译缓存的实操步骤
- 在
config/packages/twig.yaml中显式设置：twig: cache: false
（注意：不是注释掉，是明确设为false） - 确认该配置生效于当前环境：检查
APP_ENV=dev时是否加载了这个文件（可通过php bin/console debug:config twig查看cache值） - 手动清空 Twig 缓存目录：
rm -rf var/cache/dev/twig/（仅 dev 环境需要；prod 环境不能关，否则性能暴跌） - 如果用了自定义 Twig 加载器或 bundle 覆盖了默认配置，需同步检查其
Resources/views/是否被正确扫描（php bin/console twig:debug可验证模板路径）
部署测试时模板仍不更新的常见坑
部署脚本常忽略缓存清理，或权限问题导致缓存无法重建：
-
var/cache/目录属主不是 Web 服务器用户（如 www-data），导致新请求无法写入新缓存，只能读旧缓存 → 执行chown -R www-data:www-data var/cache - 使用
composer install --no-dev部署时，若未加--optimize-autoloader，可能触发 autoloader 缓存干扰 Twig 行为（少见但存在）→ 测试时先临时去掉--no-dev排查 - 模板路径写错，比如用了
@App/xxx.html.twig但实际文件在templates/下（Symfony 3 默认不启用templates/目录自动映射）→ 改用app/Resources/views/或在twig.yaml中配置paths - 浏览器或反向代理（如 Nginx fastcgi_cache）缓存了整页 HTML → 在控制器里加
$response->setPrivate()->setMaxAge(0)或临时禁用代理缓存
测试阶段更安全的替代方案
完全关掉 Twig 缓存虽能见效，但掩盖了真实部署行为。推荐在测试环境保持缓存开启，只做精准刷新：
- 每次部署后执行：
php bin/console cache:clear --env=dev（它会连带清空 Twig 编译缓存） - 用
php bin/console twig:debug确认模板路径和继承关系是否符合预期 - 检查
var/cache/dev/twig/下是否有对应模板的哈希命名文件，且修改时间与你部署时间一致 - 若必须热更新（如 CI/CD 测试），可在部署脚本末尾加：
find var/cache/dev/twig -name "*.php" -delete
真正要盯住的是缓存目录的可写性与时间戳一致性，而不是以为“关了 debug 就万事大吉”。模板更新失败，90% 出在文件系统层，不是 Twig 配置本身。
