模板修改不生效需先确认是否真在dev环境：检查url含/app_dev.php、app_env=dev已设置、twig.cache=false在config_dev.yml中配置，并清除var/cache/dev/twig/；再排查web服务器缓存、模板路径与bundle注册。
模板修改不生效，先确认是否在 dev 环境运行
Symfony 3 默认在 dev 环境下启用模板缓存，但缓存行为受环境配置和服务器设置双重影响。很多情况下你以为在 dev，实际却跑在 prod ——比如访问的是 /app.php 而不是 /app_dev.php，或者 Web 服务器重写了路由，把所有请求都导向了 prod 入口。
验证方式很简单：打开浏览器地址栏，手动加上 /app_dev.php（如 http://localhost/app_dev.php/my-route），看是否出现 Symfony 的调试工具栏。没有？那大概率没走对入口。
- 确保
app_dev.php文件权限可执行（尤其在 Nginx 下） - 检查 Web 服务器配置是否禁止了
.php文件直接访问（常见于某些 shared hosting） - 确认
APP_ENV=dev已在.env或web/app_dev.php中显式设置
关闭 Twig 模板缓存的正确配置位置
Twig 缓存在 Symfony 3 中由 templating 引擎控制，不能只改 config.yml 里的 cache: false ——那是旧版写法，Symfony 3.4+ 已弃用。真正起作用的是 twig 配置块下的 cache 选项，且必须放在 config_dev.yml 里（config_prod.yml 里设它没意义）。
在 app/config/config_dev.yml 中添加或确认以下内容：
twig:
cache: false
debug: true
注意：cache: false 是布尔值，不是字符串 'false'；如果写成字符串，Twig 会把它当路径解析，反而创建一个叫 false 的缓存目录，导致更隐蔽的问题。
- 删掉
var/cache/dev/twig/目录后再试，避免旧缓存残留 - 若用了自定义 Twig 加载器（如
FilesystemLoader），需同步检查其getCacheKey()是否返回稳定值 - 模板继承链中任一父模板被缓存，子模板改了也不生效 —— 所以建议全关
Apache/Nginx 下静态资源与 PHP 缓存干扰排查
即使 Twig 缓存关了，浏览器或代理仍可能返回旧 HTML。这不是 Symfony 的问题，但常被误判为“模板没更新”。重点查三处：
- 浏览器强制刷新：用
Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（macOS），绕过内存缓存 - HTTP 响应头中的
Cache-Control: max-age=3600或ETag—— 查看 Network 面板，确认响应头是否含X-Debug-Token（dev 环境该有） - Nginx 的
fastcgi_cache或 Apache 的mod_cache若启用，会缓存整个 PHP 输出，必须禁用或加no-cache规则
例如 Nginx 开发配置中应包含：
location ~ ^/(app_dev|app)\.php(/|$) {
fastcgi_cache off;
fastcgi_no_cache 1;
}
开发时仍卡住？检查 Twig 加载路径和命名空间
有时改了文件，但 Symfony 根本没加载它——因为路径不对、命名空间错或 bundle 未启用。典型表现是：改了 src/AppBundle/Resources/views/base.html.twig，但页面还是老样子，而 base.html.twig 实际被加载的是 vendor/symfony/symfony/src/Symfony/Bundle/FrameworkBundle/Resources/views/Exception/exception.html.twig。
验证当前模板实际来源：开启 debug 后，在 Twig 调试工具栏点击“Templates”，能看到每个渲染模板的绝对路径和加载器类型（FilesystemLoader or ChainLoader）。
- 检查
app/config/config.yml中templating: engines: ['twig']是否启用 - 确认模板路径拼写无误：
@AppBundle/Default/index.html.twig中的AppBundle必须与 Bundle 类名一致（AppBundle→AppBundle\AppBundle） - Bundle 是否在
AppKernel.php的registerBundles()中注册？漏注册会导致模板加载器跳过该路径
最麻烦的情况是多个 Bundle 定义了同名模板（比如都提供 base.html.twig），Twig 会按 Bundles 注册顺序取第一个匹配项——这个顺序容易被忽略，却直接决定你改的文件是否生效。
