当建立关联时，Sequelize会为模型添加哪些方法/混入？

前置说明 #

写这篇内容后没多久，我专门对Sequelize官方文档的关联部分做了不少优化更新，覆盖了基础到进阶的内容。建议你优先去看官方新文档，下面是之前整理的问答内容，供你参考：

• 关联基础教程
• 关联进阶教程
• HasOne API参考
• HasMany API参考
• BelongsTo API参考
• BelongsToMany API参考

原问题 #

在查阅Sequelize文档的过程中，更具体地说，我搞不清HasOne、HasMany、BelongsTo和BelongsToMany这几种关联的区别，还有怎么正确配置它们，能帮我解释下吗？

核心关联类型拆解 #

先把这几个关联的本质给你讲透，都是日常开发里高频用到的：

• HasOne：简单说就是「一对一」的“拥有”关系，比如一个用户对应唯一的个人档案。配置的时候要在“拥有方”（比如User模型）里定义，会自动在被关联的表（Profile表）生成外键指向User的主键。
  示例代码：

  User.hasOne(Profile);
  

• HasMany：这是「一对多」关系，比如一个博客作者能写N篇文章。同样在“一方”（Author模型）定义，多篇文章的表（Article）里会生成外键关联作者ID。
  示例代码：

  Author.hasMany(Article);
  

• BelongsTo：和上面的HasOne/HasMany是互逆关系，代表「属于」，比如一篇文章属于某个作者。要在“多方”或者“被拥有方”（Article模型）里定义，外键同样在Article表（和HasMany对应的外键是同一个，只是从不同视角定义）。
  示例代码：

  Article.belongsTo(Author);
  

• BelongsToMany：这是「多对多」关系，典型场景比如学生和课程——一个学生选多门课，一门课有多个学生。这种关联会自动生成中间表，用来存两者的主键对应关系。
  示例代码：

  Student.belongsToMany(Course, { through: 'StudentCourse' });
  Course.belongsToMany(Student, { through: 'StudentCourse' });
  

避坑配置小贴士 #

• 外键名称别全靠自动生成，比如在hasOne里加foreignKey: 'user_id'来指定字段名，避免出现不符合你数据库命名规范的字段。
• 如果多对多的中间表需要额外字段（比如学生的课程成绩），不能只传字符串作为through，得单独定义一个中间模型：

  const StudentCourse = sequelize.define('StudentCourse', {
    grade: DataTypes.STRING
  });
  Student.belongsToMany(Course, { through: StudentCourse });
  Course.belongsToMany(Student, { through: StudentCourse });
  

• 查询关联数据的时候，记得用include选项，比如User.findAll({ include: Profile })就能一次性把用户和对应的档案数据查出来，不用分开查两次。

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