翻译域是影响加载、缓存、提取和协作的关键结构，必须严格遵循domain.locale.loader命名规则；Symfony 4默认仅识别xlf文件，用yml需手动注册YamlFileLoader服务，调用时须显式指定domain参数。

在 Symfony 4 中，翻译域（domain）不是命名标签，而是影响加载、缓存、提取和协作的关键结构。配置错一个字母或路径，trans() 就会静默返回原文——不报错，但也不翻译。

目录与文件名必须严格匹配 domain.locale.loader

Symfony 4 默认只扫描 translations/ 目录，且仅识别符合 domain.locale.loader 格式的文件名：

• domain：如 messages、validators、emails，小写，不含空格或大写字母
• locale：如 en、zh_CN、fr_FR，区分大小写，下划线不能省略
• loader：即后缀，xlf（XLIFF，Symfony 4 默认支持）、yml 或 yaml（需启用 YAML 加载器）、php

✅ 正确示例：
translations/messages.en.xlf
translations/validators.zh_CN.yml
translations/emails.fr.php

❌ 错误示例：
translations/messages.en.yaml（.yaml 后缀在 Symfony 4 中默认不识别，须用 .yml）
translations/Messages.en.xlf（domain 首字母大写）
translations/messages_en.xlf（缺少点号分隔）

启用 YAML 支持（如需用 .yml/.yaml）

Symfony 4 默认只注册 XLIFF 加载器。若要用 YAML 格式，需手动启用：

Symfony Linux版

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

下载

在 config/packages/translation.yaml 中添加：

framework:
    translator:
        default_path: '%kernel.project_dir%/translations'
        fallbacks: ['en']
        providers: ~
<h1>显式启用 YAML 加载器</h1><p>services:
Symfony\Component\Translation\Loader\YamlFileLoader:
tags: [{ name: 'translation.loader', alias: 'yml' }]

之后才能识别 .yml 文件；.yaml 仍不支持，除非额外注册别名。

代码中调用指定 domain 的方法

不传 domain 参数时，一律走 messages 域。多域必须显式声明：

• 控制器中：$translator->trans('email.subject.welcome', [], 'emails')
• Twig 模板中：{{ 'submit'|trans({}, 'messages') }}
• Twig 中带参数的写法：{% trans with {'%name%': user.name} from 'emails' %}Hi %name%{% endtrans %}

注意：Symfony 4 的 Twig 不支持 trans('key', domain: 'xxx') 这种新语法（那是 Symfony 5.4+ 的特性），必须用数组参数形式或 from 子句。

验证是否生效的快速检查法

运行命令确认 Symfony 是否已加载目标 domain：

php bin/console debug:translation en --domain=emails

若无输出或提示“no messages found”，说明文件未被识别——优先检查：
• 文件是否放在 translations/ 下
• 文件名是否拼写准确（尤其 locale 大小写、点号位置）
• 是否清除了缓存：php bin/console cache:clear