Symfony包模板覆盖核心是不改vendor，只在项目内新建同路径文件：位置、命名、大小写、扩展名必须严格匹配原Bundle结构，清缓存后自动生效；表单主题需显式引入或全局配置。
Symfony包模板覆盖，核心就一条：不改 vendor，只在项目内新建同路径结构的文件。只要位置对、命名准、缓存清，覆盖立刻生效。
覆盖位置必须严格匹配Bundle结构
每个Bundle的模板默认从 vendor/xxx-bundle/Resources/views/ 加载。要覆盖它，就得在项目中模拟出完全一致的路径层级：
- FOSUserBundle 的登录页是
Resources/views/Security/login.html.twig→ 覆盖文件放templates/bundles/FOSUserBundle/Security/login.html.twig（Symfony 4+ 推荐）或app/Resources/FOSUserBundle/views/Security/login.html.twig（旧版） - TwigBundle 的 404 页面是
Resources/views/Exception/error404.html.twig→ 放到templates/bundles/TwigBundle/Exception/error404.html.twig - GeneratorBundle 的 CRUD index 模板 → 对应路径是
templates/bundles/SensioGeneratorBundle/skeleton/crud/views/index.html.twig
路径里大小写、斜杠方向、文件扩展名都必须和原Bundle完全一致，否则 Symfony 找不到。
优先级规则：项目模板 > Bundle 默认模板
Symfony 查找模板时按固定顺序扫描：
- 先查
templates/bundles/XXXBundle/...（Symfony 4.4+ 主力路径） - 再查
app/Resources/XXXBundle/views/...（兼容旧项目） - 最后回落到
vendor/xxx-bundle/Resources/views/...
只要前两级存在且路径正确，就不会加载 vendor 里的原始模板。不需要额外配置，也不用注册——这是 Symfony 内置机制。
覆盖后必须清除缓存
模板覆盖不是实时生效的。每次新增或修改覆盖模板后，务必运行：
php bin/console cache:clear
开发环境可加 --env=dev，生产环境必须加 --env=prod 并确保权限正常。如果仍不生效，可追加 --no-warmup 后重试，排除预热干扰。
表单主题等特殊模板需显式启用
像自定义表单渲染（如 form_row、checkbox_widget）不属于“页面模板”，而是 Twig 表单主题。这类文件不会自动覆盖，必须手动引入：
- 把
my_form_theme.html.twig放在templates/form/下 - 在使用表单的 Twig 文件顶部写：
{% form_theme form 'form/my_form_theme.html.twig' %} - 或全局启用：在
config/packages/framework.yaml中添加form_themes: ['form/my_form_theme.html.twig']
注意 block 名称必须与 Symfony 默认主题中的完全一致（比如 textarea_widget 不是 text_widget），拼错就不会触发。
