如何将Rails唯一性校验消息迁移至i18n本地化文件并通过Rubocop检查

要解决这个问题，需要调整en.yml的配置结构，并修改模型中的校验语句，让它正确读取本地化文本：

1. 修正en.yml的配置层级 #

Rails的ActiveRecord错误消息有严格的层级结构，针对属性的自定义校验消息需要放在models.[模型名].attributes.[属性名]下。修改你的en.yml如下：

# en.yml
activerecord:
  errors:
    models:
      publication:
        attributes:
          base:
            must_be_in_future: Release date must be in future
      department:
        attributes:
          role:
            # 自定义错误消息键，名称可自行定义
            admin_already_present: 'admin is already present'

2. 修改模型中的校验语句 #

去掉硬编码的字符串消息，改用自定义的I18n键名，让校验逻辑读取本地化配置：

# app/models/department.rb
...
validates :role, uniqueness: { scope: :company, message: :admin_already_present }, if: -> { role_admin? }

额外说明 #

如果需要让消息更灵活（比如动态显示角色或公司名称），可以在en.yml中使用插值变量：

admin_already_present: '%{value} 已在 %{company} 中存在'

此时Rails会自动将校验的value（即当前role的值）和scope对应的company值填充到消息中。

内容的提问来源于stack exchange，提问作者Meltemi