翻译域是Symfony中组织消息的关键逻辑分组，影响加载、缓存与维护；默认为messages，但多类文本需划分validators、emails等独立domain以避免冲突、提升缓存效率和提取精度。

翻译域（domain）是 Symfony 翻译系统中组织消息的逻辑分组方式，不是可有可无的标签，而是影响加载、缓存、复用和维护的关键设计。默认域为 messages，但项目一旦涉及多类文本（如表单验证、邮件模板、前端组件提示），就必须合理划分 domain。

为什么需要多个翻译域

把所有字符串塞进 messages.en.yaml 看似省事，实际会带来三类问题：

• 不同模块或功能的翻译混在一起，协作时易冲突（比如“submit”在登录页和订单页语义不同）
• 缓存无法按需刷新——改了一条邮件文案，整个 messages 域缓存全失效
• 提取工具（translation:extract）难以精准过滤，生成冗余键值

常见 domain 命名与使用场景

推荐采用小写+点号分隔的命名习惯，清晰表达归属：

• messages：通用界面文案（按钮、标题、提示语）
• validators：表单验证错误信息（Symfony 自动使用此域）
• emails：邮件主题与正文（便于单独导出给翻译团队）
• admin 或 user：按权限/角色隔离的后台或用户端文案
• api：API 返回的 JSON 错误消息（适合前后端分离项目）

每个 domain 对应独立文件，例如：
translations/messages.en.yaml
translations/validators.fr.yaml
translations/emails.zh_CN.yaml

代码中指定 domain 的两种方式

不显式指定 domain 时，一律走 messages。要调用其他域，必须传参：

• 在控制器或服务中使用 Translator：

$translator->trans('password_too_short', [], 'validators');

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

• 在 Twig 模板中使用 trans filter 或 tag：

{{ 'welcome'|trans({}, 'messages') }}
{% trans with {'%name%': 'Alice'} from 'messages' %}Hello %name%{% endtrans %}

配置与加载注意事项

Symfony 默认只扫描 translations/ 目录下的文件，且自动识别文件名中的 domain 名。例如：

• translations/emails.en.yaml → domain = emails, locale = en
• translations/admin.de.xlf → domain = admin, locale = de

无需额外配置 loader；但若使用自定义路径（如按 bundle 分开存放），需在 config/packages/translation.yaml 中补充：

translator:
  paths:
    - '%kernel.project_dir%/src/Bundle/AdminBundle/Resources/translations'

注意：多个路径存在同名 domain + locale 组合时，优先级按路径列表顺序从上到下，前者覆盖后者。