Symfony默认不自动加载翻译资源，trans()返回原文主因是未配置default_path或路径无效；须在translation.yaml中显式设framework.translator.default_path为'%kernel.project_dir%/translations'，并确保目录存在、命名规范（如messages.fr.xlf）、域匹配且Twig正确注入translator服务。
Symfony 默认不自动加载任何翻译资源，trans() 调用返回原文，大概率不是漏翻译，而是根本没加载文件。
确认 translator.default_path 配置是否生效
这是最常被忽略的一步。Symfony 6+ 不再默认扫描 translations/ 目录，必须显式声明路径。
- 检查
config/packages/translation.yaml是否包含：framework: translator: default_path: '%kernel.project_dir%/translations' - 确保该目录真实存在且 Web 服务器有读取权限（如
ls -l translations/） - 文件命名必须严格匹配：例如法语主消息文件是
translations/messages.fr.xlf，不是messages.fr.yaml—— 后者需额外启用 YAML 加载器 - 若使用自定义域（如
admin.fr.xlf），调用时必须指定：$translator->trans('key', domain: 'admin')，否则仍查messages域
确保 Twig 模板能正确使用 trans 过滤器
Symfony 5.4+ 默认禁用全局 trans 函数，Twig 中直接写 {{ 'hello'|trans }} 会报错或静默失败。
- 在
config/packages/twig.yaml中显式注入服务：twig: globals: translator: '@translator' - 更推荐方式：控制器中注入
TranslatorInterface，再传给模板变量，避免全局污染 - 若需强制指定语言（比如不依赖当前请求 locale），在模板中写：
{{ 'hello'|trans({}, 'messages', 'fr') }} - 动态 locale（如从 URL 取
_locale）不能在模板里硬写app.request.get('_locale')，应由控制器解析后传入
让 Translator 的 locale 随路由实时更新
即使 URL 是 /fr/news，$translator->trans() 仍返回英文，说明 locale 没同步到 Translator 实例。
- 确认
config/routes.yaml已启用 locale 前缀：controllers: resource: ../src/Controller/ type: annotation prefix: '/{_locale}' defaults: { _locale: '%kernel.default_locale%' } - 检查
config/packages/framework.yaml中default_locale: en是否被环境变量覆盖（如APP_ENV=prod下未设APP_DEFAULT_LOCALE） - 调试时打印：
dump($translator->getLocale())，若始终是en，说明LocaleAwareListener未触发 —— 它依赖 session，确认framework.session已启用
XLIFF 加载慢？别盲目堆 fallback 语言
加一堆 setFallbackLocales(['en', 'es', 'de']) 不解决性能问题，反而让每次 trans() 都要遍历多个 catalog。
- 真正影响响应时间的是 XLIFF 文件体积和解析开销，尤其含大量注释或嵌套结构时
- 生产环境务必开启翻译缓存：
framework.translator.cache_dir: '%kernel.cache_dir%/translations' - 避免在单个 XLIFF 中塞进所有语言；按功能域拆分（
messages.fr.xlf,admin.fr.xlf,email.fr.xlf），只加载当前需要的域 - 若用第三方翻译服务，优先走
TranslationProviderCollection+ 缓存，而非每次拉全量 XLIFF
最易被忽略的点：XLIFF 文件本身是否语法合法。一个未闭合的 <target> 标签会让整个文件加载失败，但 Symfony 默认不报错 —— 用 php bin/console lint:translations 定期检查，比等用户反馈“中文变英文”更早发现问题。
