Twig中{{ 'hello'|trans }}不生效主因是locale未激活或配置断点：需确认translation.yaml中default_locale设置、messages.zh-CN.xlf文件存在且命名规范、Twig已启用TranslationExtension并注册trans过滤器，缺一不可。
Twig 模板中 {{ 'hello'|trans }} 翻译不生效，通常不是语法写错，而是底层语言环境没真正激活或配置断点在关键环节。Symfony 4 的本地化依赖三层协同：系统 locale 设置、Translator 组件配置、以及 Twig 的 trans 过滤器绑定。任一环缺失，翻译就静默失败（返回原文，无报错）。
确认 locale 是否被 Symfony 正确识别
Twig 的 |trans 过滤器最终调用 Translator，而 Translator 默认只响应 kernel.default_locale 配置的语言，除非你显式传入 locale 或启用了自动切换逻辑。
- 检查
config/packages/translation.yaml中是否设置了default_locale: 'zh-CN'（注意格式必须与语言包目录名一致） - 运行
php bin/console debug:translation zh-CN，看是否列出你的翻译键——如果命令报“no messages found”，说明语言包未加载或路径错误 - 临时加一行
{{ app.request.locale|default(app.session.get('_locale') ?: 'en') }}到模板里，确认当前实际生效的 locale 是什么
验证翻译文件位置与命名是否合规
Symfony 4 要求翻译文件严格按约定存放，大小写、扩展名、目录层级缺一不可：
- 文件必须放在
translations/目录下（非app/Resources/translations） - 命名格式为
messages+intl-icu.zh-CN.xlf或messages.zh-CN.yaml；若用 XLIFF，根<file></file>标签的target-language属性必须是zh-CN - YAML 文件需为合法结构：
hello: "你好"，不能有中文缩进或 BOM 头 - 修改后清缓存：
php bin/console cache:clear --env=dev（开发环境也要清，因翻译文件会被编译缓存）
检查 Twig 是否启用 translation 扩展
即使 Translator 配置正确，Twig 若未注册 TranslationExtension，|trans 过滤器也不会存在。
- 确认
config/packages/twig.yaml包含default_path: '%kernel.project_dir%/templates'，且未禁用extensions - 运行
php bin/console debug:twig | grep trans，应看到trans,transchoice等过滤器已注册 - 如未列出，检查是否误删了
symfony/translation包，或config/bundles.php中TranslationBundle::class是否设为true
绕过缓存快速验证基础流程
写一段最小可测代码，排除模板继承、块覆盖等干扰：
- 新建
templates/test.html.twig，内容仅一行：{{ 'hello'|trans }} - 新增路由指向该模板，不经过任何 Controller 逻辑
- 访问该路由，同时打开 Web Profiler → Translation 面板，查看“Missing translations”和“Defined translations”两栏是否匹配
- 若此处仍不生效，问题一定出在翻译文件加载或 locale 初始化上，而非业务逻辑
