为何可直接访问Sequelize模型的数据值？实现原理解析

嘿，这个问题我刚用Sequelize的时候也懵过——明明打印实例能看到数据都藏在dataValues里，却能直接用myModel.myCustomAttribute拿到值，感觉像个小魔法！其实核心原理和几个容易忽略的知识点我给你拆解清楚：

核心实现：ES6的Getter/Setter + 动态属性定义 #

Sequelize在创建模型类的时候，会遍历你定义的所有数据库字段，用Object.defineProperty()在模型的原型上给每个字段动态添加getter和setter方法。

举个简化版的实现逻辑，大概是这样：

// Sequelize内部会给每个字段生成类似的代码
Object.defineProperty(Model.prototype, 'myCustomAttribute', {
  get() {
    // 访问属性时，实际从dataValues里取数
    return this.dataValues.myCustomAttribute;
  },
  set(newValue) {
    // 赋值时，把值存到dataValues，同时标记字段已修改
    this.dataValues.myCustomAttribute = newValue;
    this._changed.myCustomAttribute = true;
  },
  enumerable: true // 让这个属性能被遍历到，看起来像实例本身的属性
});

当你写myModel.myCustomAttribute时，本质是调用了这个getter方法，它帮你从dataValues里取出对应的值；赋值时则调用setter，同时自动维护_changed、_prevValues这些状态属性——这也是为什么Sequelize能精准知道哪些字段需要更新的原因。

容易忽略的几个关键点 #

• enumerable属性的作用：默认情况下，用Object.defineProperty定义的getter/setter是不可枚举的（也就是打印实例或者用Object.keys()看不到）。Sequelize特意设置了enumerable: true，所以这些属性会和实例本身的options、isNewRecord等属性一起被展示出来，让你误以为是实例的直接属性。

• 状态自动管理：直接访问/赋值属性时，Sequelize会自动更新_prevValues（保存修改前的原始值）、_changed（标记哪些字段被修改）这些内部状态。比如你修改了myModel.name，_changed.name就会变成true，调用save()时就只会更新这个字段，而不是全量更新。

• 自定义Getter/Setter的坑：如果你自己给模型字段加了自定义getter/setter，千万不要直接用this.myField访问，否则会递归调用getter导致栈溢出！正确的做法是用this.getDataValue('myField')和this.setDataValue('myField')直接操作dataValues，比如：

  const User = sequelize.define('User', {
    fullName: {
      type: DataTypes.STRING,
      get() {
        return `${this.getDataValue('firstName')} ${this.getDataValue('lastName')}`;
      },
      set(value) {
        const [first, last] = value.split(' ');
        this.setDataValue('firstName', first);
        this.setDataValue('lastName', last);
      }
    }
  });
  

• toJSON()的自动展平：当你把实例转成JSON（比如传给前端）时，Sequelize的toJSON()方法会自动把dataValues里的字段展平，所以你拿到的JSON对象直接就有myCustomAttribute，而不是嵌套在dataValues里——这也是为了适配前端的使用习惯。

总结 #

说白了，Sequelize就是用ES6的属性代理机制，把dataValues里的数据库字段“映射”到实例本身，既让使用起来更直观（不用每次写dataValues），又偷偷帮你做了状态管理、字段更新追踪这些脏活。这也是它作为ORM框架的便利性之一~

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