为何SQLAlchemy模型类需继承Base而非直接继承DeclarativeBase？

你提到的两种写法确实都能运行，但官方推荐自定义Base类作为所有模型的父类，核心原因是为了扩展性、可维护性和统一管理，具体来说有这几点：

• 统一扩展模型能力
  一开始Base类看似是空的，但后续项目迭代中，你可以很方便地给它添加全局配置或通用功能，所有继承它的模型会自动继承这些特性，不用逐个修改：

  from sqlalchemy import Integer, mapped_column
  from sqlalchemy.orm import DeclarativeBase
  
  class Base(DeclarativeBase):
      # 给所有模型统一添加主键字段
      id = mapped_column(Integer, primary_key=True, autoincrement=True)
      # 或者添加通用方法，比如转字典
      def to_dict(self):
          return {c.name: getattr(self, c.name) for c in self.__table__.columns}
  

  如果直接让模型继承DeclarativeBase，要实现这类全局特性，就得在每个模型里重复写代码，后期维护成本极高。

• 元数据集中管理
  每个DeclarativeBase子类都会生成独立的MetaData对象，这个对象负责跟踪所有关联表的结构、约束等信息。如果所有模型都直接继承DeclarativeBase，每个模型会属于不同的MetaData集合，后续创建表、迁移表结构时，你得逐个处理：

  # 直接继承DeclarativeBase的情况，需单独创建每个模型的表
  User.metadata.create_all(engine)
  Address.metadata.create_all(engine)
  

  而用自定义Base的话，所有模型共享同一个MetaData，只需一行代码就能创建所有表：

  # 自定义Base的情况，一次性创建所有关联表
  Base.metadata.create_all(engine)
  

  这在表数量多的项目里能节省大量重复代码。

• 代码结构清晰，降低维护成本
  统一用Base作为模型基类，项目结构更规整，新接手的开发者一眼就能明确模型的继承关系。后期如果要调整全局配置（比如修改元数据绑定、添加全局查询选项），只需要修改Base类，不用遍历所有模型文件逐个修改。

• 隔离框架版本变更影响
  DeclarativeBase是SQLAlchemy官方提供的基类，未来版本更新可能会对它的属性或行为做调整。自定义Base相当于一个中间层，能缓冲框架变更带来的影响——比如新版本新增了特性，你可以先在Base里做适配，再同步给所有模型，避免直接修改大量模型代码。

写法对比 #

官方推荐写法（自定义Base）：

>>> class Base(DeclarativeBase):
...     pass

>>> class User(Base):
...     __tablename__ = "user_account"
...     # 模型字段

>>> class Address(Base):
...     __tablename__ = "address"
...     # 模型字段

你提出的直接继承写法：

>>> class User(DeclarativeBase):
...     __tablename__ = "user_account"
...     # 模型字段

>>> class Address(DeclarativeBase):
...     __tablename__ = "address"
...     # 模型字段

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