symfony 4翻译加载失败最常见表现是trans()返回原文，主因是未配置default_path；须在translation.yaml中设framework.translator.default_path为'%kernel.project_dir%/translations'，并确保目录存在、命名规范（如messages.fr.xlf）、xliff格式、twig注入translator服务且locale动态生效。
Symfony 4 中翻译文件加载失败，最常见表现是 trans() 或 {{ 'key'|trans }} 始终返回原文，不是漏翻，而是根本没加载任何翻译资源。核心问题在于 Symfony 4 默认不扫描 translations/ 目录，必须手动配置路径并确保格式、命名、域和注入全部到位。
确认 translation.yaml 中已声明 default_path
这是首要且最容易被跳过的步骤。Symfony 4 不再默认加载 translations/ 下的文件，必须显式指定位置。
- 检查
config/packages/translation.yaml是否包含以下配置：
framework:
translator:
default_path: '%kernel.project_dir%/translations'
- 确保该目录真实存在：
ls -l translations/，且 Web 服务器用户（如 www-data）有读取权限 - 若使用自定义路径（如
src/Resources/translations），需同步更新此配置
验证翻译文件命名与格式是否合规
Symfony 4 默认只识别 XLIFF 格式（.xlf），YAML（.yaml）需额外启用加载器，且命名必须严格匹配规则。
- 标准消息文件应命名为：
translations/messages.fr.xlf、translations/messages.en.xlf - 不能写成：
messages.fr.yaml、fr.messages.xlf或Translations/messages.fr.xlf（大小写和路径都敏感） - 若坚持用 YAML，请在
config/packages/framework.yaml中启用：
framework:
translation:
enabled: true
providers: ['yaml']
检查 Twig 模板中 trans 过滤器是否可用
Symfony 4 允许全局使用 {{ 'key'|trans }}，但前提是 translator 服务已注入 Twig 全局变量。
- 在
config/packages/twig.yaml中添加：
twig:
globals:
translator: '@translator'
- 或更推荐的方式：控制器中注入
TranslatorInterface，再以变量形式传入模板，避免全局依赖 - 调用时若指定语言，应写为：
{{ 'hello'|trans({}, 'messages', 'fr') }}，而非依赖app.request.get('_locale')—— 后者应在控制器中解析后传入
确认 locale 是否随请求动态生效
即使 URL 是 /fr/contact，trans() 仍返回英文，说明 Translator 实例未同步当前请求的语言环境。
- 检查
config/routes.yaml是否启用 locale 前缀：
controllers:
resource: ../src/Controller/
type: annotation
prefix: '/{_locale}'
defaults: { _locale: '%kernel.default_locale%' }
- 运行
php bin/console debug:router确认路由含_locale参数 - 在控制器中 dump($translator->getLocale())，若始终是
en，说明 LocaleAwareListener 未触发——请确认framework.session已启用
