必须启用Symfony Translation组件并配置translation.yaml启用翻译器、设置default_locale；在translations/目录下按locale创建messages.en.yaml和messages.zh.yaml等翻译文件；模板中用{{ 'app.welcome'|trans }}调用翻译，支持域指定和占位符传参；通过session存储locale并配合路由与链接实现动态语言切换。
在 Symfony 4 中使用 Twig 的 |trans 过滤器实现本地化，核心是让翻译组件与模板正确协同——不是写个翻译文件就能自动生效，关键在配置、域管理、占位符用法和 locale 传递链的完整性。
确保翻译组件已启用并设好默认语言
检查 config/packages/translation.yaml 是否存在且内容为：
framework:
translator:
enabled: true
default_locale: 'en'
若文件不存在，请手动创建。缺 default_locale 会导致 |trans 返回原始键名（如 app.welcome），而非翻译文本。
运行命令确认组件已加载：php bin/console debug:config framework | grep translator
按规范组织翻译文件
在项目根目录下创建 translations/ 文件夹，文件命名必须符合 messages.{locale}.yaml 格式：
-
translations/messages.en.yaml：app.welcome: "Welcome back" -
translations/messages.zh.yaml：app.welcome: "欢迎回来"
注意：
– 文件名中的 messages 是默认翻译域（domain），不可省略或拼错；
– locale 标识符（如 zh）需与系统支持的语言标签一致，避免用 cn 或 zho；
– YAML 缩进必须用空格，不能用 Tab。
在 Twig 模板中正确调用 trans 过滤器
基础用法（依赖当前请求 locale）：
{{ 'app.welcome'|trans }}
指定翻译域（如使用 admin 域）：
{{ 'admin.dashboard'|trans(domain='admin') }}
带参数的翻译（占位符严格匹配）：
- 在
messages.en.yaml中写：user.greeting: "Hello %name%!" - 模板中调用：
{{ 'user.greeting'|trans({ '%name%': 'Emma' }) }}
输出：Hello Emma!
⚠️ 常见错误：
– 写成 %NAME% 或 % name % → 不会替换；
– 忘记传参数组（只写 |trans）→ 占位符原样输出。
让语言切换真正生效
Symfony 4 默认不自动读取 URL 或 session 中的 locale，需手动干预：
- 在控制器中设置 session locale：
$request->getSession()->set('_locale', 'zh'); - 确保
config/packages/framework.yaml启用了 session：session: { enabled: true } - Twig 模板中加切换链接（示例）：
<a href="{{ path('set_locale', {locale: 'en'}) }}">EN</a> | <a href="{{ path('set_locale', {locale: 'zh'}) }}">中文</a>
路由 set_locale 对应的控制器动作里，执行 session 设置并重定向回原页即可。
