symfony 4校验提示本地化核心是通过翻译组件自动翻译constraints错误消息，依赖validators域xliff文件（如validators.zh_cn.xlf），需配置default_locale、使用标准约束不硬编码message，并确保source与英文原消息完全一致。
Symfony 4 中校验提示信息的本地化，核心是让 Constraints（如 @Assert\NotBlank、@Assert\Email）抛出的错误消息按当前语言环境（locale）自动翻译。这依赖于 Symfony 的翻译系统和校验器对翻译域的约定，不是简单改写注解里的 message 字符串。
确保启用翻译组件并配置默认 locale
Symfony 4 默认已启用 symfony/translation，但需确认 config/packages/translation.yaml 存在且未被禁用：
config/packages/translation.yaml
framework:
default_locale: 'zh_CN'
translator:
default_path: '%kernel.project_dir%/translations'
fallbacks:
- 'en'
同时确保 kernel.default_locale 或请求中的 locale 已正确设置（例如通过 URL、session 或 setLocale()）。
使用标准校验约束，不硬编码 message
在实体中避免手动指定中文字符串，保持约束“干净”，让翻译系统接管：
use Symfony\Component\Validator\Constraints as Assert;
<p>class User
{
/**</p>
- @Assert\NotBlank(
- // 不要写：message="用户名不能为空"
- )
*/
private $username;
}
这样校验器会自动查找翻译域
validators下对应 key 的翻译，例如：validators.not_blank→ 对应validators.zh_CN.xlf中的条目。
在 translations/ 目录下添加 validators.{locale}.xlf
在项目根目录的 translations/ 文件夹中创建 XLIFF 文件（推荐），例如：
translations/validators.zh_CN.xlf
<?xml version="1.0"?><xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2"><file source-language="en" datatype="plaintext" original="file.ext"><trans-unit id="not_blank"><source>This value should not be blank.</source><target>该值不能为空。</target></trans-unit><trans-unit id="email"><source>This value is not a valid email address.</source><target>该值不是有效的邮箱地址。</target></trans-unit><!-- 更多约束可查 vendor/symfony/validator/Resources/translations/validators.en.xlf --></file></xliff>
关键点：
• <source></source> 内容必须与英文原消息**完全一致**（包括标点、大小写）；
• 文件名必须为 validators.{locale}.xlf（如 validators.zh_CN.xlf 或 validators.zh_Hans.xlf）；
• 翻译域固定为 validators，无需在约束中声明 translation_domain。
验证与调试技巧
若翻译未生效，可快速排查：
- 运行
bin/console debug:translation zh_CN --domain=validators查看缺失或未匹配的 key - 检查浏览器请求头或
Request::getLocale()是否确为zh_CN - 清除缓存：
bin/console cache:clear（开发环境有时需加--env=dev） - 临时在模板中 dump 错误：
{{ form_errors(form.username) | raw }}观察原始输出
