Symfony国际化配置核心在于三件事：让翻译文件被正确加载（需匹配XLIFF默认格式或手动启用YAML）、让请求语言实时生效（依赖路由_locale参数与session启用）、让模板和代码自然调用翻译（推荐控制器注入TranslatorInterface传值，而非模板中直接trans()）。
Symfony国际化配置核心在于三件事：让翻译文件被正确加载、让请求语言能实时生效、让模板和代码里能自然调用翻译。配错一个环节，就可能出现“调了trans()却还是显示英文”这类问题。
翻译文件路径与格式必须对得上
Symfony 6+ 默认只自动加载 XLIFF 格式（messages.en.xlf），不是 YAML。如果你用的是 messages.en.yaml，必须手动启用 YAML 支持：
- 确认
config/packages/translation.yaml中设置了default_path: '%kernel.project_dir%/translations'，且该目录真实存在、可读 - 检查文件命名是否规范：必须是
messages.{locale}.xlf（如messages.zh.xlf），不能是zh/messages.xlf或admin.zh.xlf（后者需显式指定 domain） - 若坚持用 YAML，在
config/packages/translation.yaml加上：framework:translation:enabled_formats: ['xlf', 'yaml']
语言切换必须绑定到请求生命周期
仅设 default_locale: en 不够，URL 中的 /fr/ 必须真正影响 Translator 的当前 locale：
- 路由要带
_locale参数，并设置约束：homepage:path: /{_locale}/defaults: { _controller: App\Controller\HomeController::index }requirements: { _locale: en|fr|zh } - 确保
config/packages/framework.yaml启用了 session：session: true（locale 切换依赖 session 存储） - 调试时打印
$translator->getLocale()，如果它没随 URL 变化，说明LocaleAwareListener没触发——检查是否漏配了上述路由参数或 session
Twig 模板里要用对翻译方式
默认情况下，Twig 的 {{ 'hello'|trans }} 是禁用的，容易报 “Translation key not found”：
- 推荐做法：控制器中注入
TranslatorInterface，把翻译结果作为变量传入模板，避免全局依赖 - 若要用过滤器，先在
config/packages/twig.yaml开启：twig:globals:translator: '@translator' - 动态 locale 场景下，不要在模板里写
{{ 'key'|trans({}, 'messages', app.request.get('_locale')) }}，而应由控制器解析后传入，更可控
回退与缓存别踩坑
翻译缺失时显示原文，不等于没配好——可能是回退或缓存干扰：
- 在
services.yaml配置 fallback：Symfony\Component\Translation\Translator:arguments: ['%locale%']calls:- [setFallbackLocales, [['en']]] - 开发阶段建议禁用翻译缓存，或每次改完翻译后清缓存：
php bin/console cache:clear - 用命令行验证：
php bin/console translation:lint zh检查中文翻译完整性php bin/console translation:extract zh --no-backup自动提取新字符串
