Rails命名空间模型迁移中引用字段的正确命名规范

在Rails「约定优于配置」的原则下，你当前使用的t.references :exam_section才是符合惯例的写法，原因如下：

• 关联字段名要和模型关联名对齐
  你的模型是Bank::ExamUnit，对应的关联应该定义为belongs_to :exam_section（而非belongs_to :bank_exam_section），迁移里的references名称必须和这个关联名保持一致，这样Rails才能自动识别关联关系，无需额外手动映射。

• 命名空间的表前缀由Rails自动处理
  命名空间模型Bank::ExamSection会自动映射到bank_exam_sections表，当你使用t.references :exam_section时，配合符合约定的模型结构，甚至可以省略to_table参数，Rails会自动推断出正确的外键目标表，简化后的迁移代码如下：

  class CreateBankExamUnits < ActiveRecord::Migration[8.0]
    def change
      create_table :bank_exam_units do |t|
        t.references :exam_section, null: false, foreign_key: true
        # ...
      end
    end
  end
  

• 保持代码简洁性与可读性
  如果使用t.references :bank_exam_section，虽然功能正常，但会迫使你在模型里定义冗余的belongs_to :bank_exam_section关联，完全违背了命名空间简化代码结构的初衷，也会让其他开发者理解关联关系时产生困惑。

内容的提问来源于stack exchange，提问作者박상원