是twig嵌套模板路径错误或未被监听所致；需确认使用逻辑路径、auto_reload为true、清除var/cache/dev/twig/目录，并检查{% cache %}标签及宏导入缓存影响。
模板嵌套修改后页面没变，是不是缓存没关？
不是“缓存没关”，而是 Symfony 3 的 Twig 模板缓存默认始终开启，且开发环境（APP_ENV=dev）下它会自动监听文件变更——但仅限于被 Twig 直接加载的模板文件。嵌套用的 include、embed 或 extends 模板若路径写错、命名空间未注册、或用了硬编码字符串而没走 Twig 的自动解析机制，修改就完全不会触发重新编译。
- 先确认是否真在 dev 环境：执行
php bin/console debug:container --env=dev | grep debug，输出里必须有debug: true；如果显示debug: false，说明环境变量被覆盖（比如.env.local里写了APP_ENV=prod） - 检查
config/packages/twig.yaml是否意外禁用了自动重编译：auto_reload必须为true（dev 下默认就是 true，但有人会手动设成 false 来“提速”，结果改了白改） - 嵌套模板路径必须用 Twig 的逻辑路径，不是物理路径。例如：
{% include 'components/_header.html.twig' %}是对的；而{% include '../templates/components/_header.html.twig' %}是错的——后者绕过 Twig loader，修改不被监听
为什么清了 cache 还是看不到嵌套模板更新？
因为 cache:clear 只删 var/cache/dev/ 下的 PHP 编译文件，而 Twig 模板缓存（var/cache/dev/twig/）是独立目录，且默认使用 FilesystemAdapter 存储。开发模式下它本该自动失效，但如果模板里用了 {% cache %} 标签、或者你启用了 cache: true 的自定义 Twig 扩展，那这部分缓存就不会随 cache:clear 一起清掉。
- 强制清理 Twig 专属缓存：运行
rm -rf var/cache/dev/twig/（Linux/macOS）或del /q var\cache\dev\twig\*（Windows CMD） - 检查有没有手写的
{% cache %}块：它默认用cache.app池，不受cache:clear影响，得单独清：php bin/console cache:pool:clear cache.app --env=dev - 确认嵌套模板没被
ignore：在twig.yaml中检查paths配置，确保你的components/目录在扫描范围内，否则 Twig 根本不把它当模板处理
如何让嵌套模板修改立即生效，不依赖缓存策略？
最可靠的方式不是关缓存，而是让 Twig 在每次请求时都校验源文件时间戳。这在开发阶段开销极小，却能彻底规避路径、监听、扩展干扰带来的“改了没反应”问题。
- 在
config/packages/twig.yaml中显式设置：auto_reload: true和cache: false（注意：仅限dev环境，prod下绝不能设false） - 确保 Web 服务器用户（如
www-data或_www）对templates/目录有读取权限；否则 Twig 读不到新文件，自然不会重编译 - 如果你用的是 PhpStorm + Symfony Plugin，检查 Settings → Languages & Frameworks → PHP → Symfony → Template Paths 是否包含你放嵌套模板的实际路径（比如
src/Resources/views），否则 IDE 不提示、Twig 也不扫描
嵌套模板中引用的宏（macro）修改不生效怎么办？
宏不是普通模板，它被导入（{% import %}）时会被静态编译进调用它的模板缓存中。也就是说，_macros.html.twig 改了，但引用它的 list.html.twig 缓存没清，宏代码还是旧的。
- 改完宏文件后，必须连带清掉所有引用它的模板缓存：直接删
var/cache/dev/twig/下对应哈希前缀的文件（比如list-*.php），或全删 - 避免在多个地方重复
{% import %}；统一在base.html.twig里导入并用global暴露，减少缓存耦合点 - 宏里不要依赖外部变量状态（如
app.request），否则缓存行为更难预测；把需要动态的东西全作为参数传入
{% cache %} 多层叠加控制。最容易被忽略的是：你以为在改模板，其实 Twig 根本没加载那个文件——它只是静默 fallback 到了缓存里的旧版本。
