symfony 4 多语言站点需正确配置 translation 组件、资源路径与 twig 全局 translator；核心问题常是翻译文件未加载，须确保 translations/ 目录存在、xliff 格式合规、fallbacks 设置合理，并在 twig.yaml 中注入 translator 实例。
Symfony 4 实现多语言站点，核心是 Translation 组件 + 正确的路径与格式配置。常见问题不是“翻译没写对”，而是资源根本没加载进来——比如 trans('hello') 一直返回原文，大概率是文件路径错、格式不支持或 Twig 没拿到 translator 实例。
安装并启用 Translation 组件
运行命令安装：
composer require symfony/translation
该命令会自动注册 TranslationBundle；若未生效，检查 config/bundles.php 是否包含：
Symfony\Bundle\TranslationBundle\TranslationBundle::class => ['all' => true],
配置默认语言与资源路径
编辑 config/packages/translation.yaml，确保内容类似：
framework:
default_locale: 'en'
translator:
default_path: '%kernel.project_dir%/translations'
fallbacks: ['en']
关键点：
-
default_path必须指向真实存在的目录（如translations/），且该目录需在项目根目录下 - Symfony 4 默认只识别 XLIFF 格式（
.xlf），YAML 文件需额外配置 loader 才能加载 -
fallbacks决定找不到当前 locale 翻译时的回退顺序，例如设为['zh_CN', 'en']表示先找中文，再找英文
创建标准 XLIFF 翻译文件
在项目根目录新建 translations/ 目录，并放入以下文件：
-
messages.en.xlf（英文） -
messages.zh_CN.xlf（简体中文） -
messages.fr.xlf（法语）
每个文件必须符合 XLIFF 1.2 规范，<file></file> 标签中 source-language 值要与文件名中的 locale 一致。例如 messages.zh_CN.xlf 的开头应为：
<xliff version="1.2"><file source-language="zh_CN" target-language="zh_CN" datatype="plaintext"></file></xliff>
Twig 中启用 trans 过滤器
Symfony 4 默认不向 Twig 全局注入 translator，需手动配置：
在 config/packages/twig.yaml 中添加：
twig:
globals:
translator: '@translator'
之后模板中即可使用：
-
{{ 'app.welcome'|trans }}（使用默认 messages 域） -
{{ 'admin.title'|trans(domain='admin') }}（指定 admin 域） -
{{ 'user.greeting'|trans({'%name%': 'Alice'}) }}（带参数替换）
注意：占位符名称必须完全一致，包括百分号和空格。
