datamodel-code-generator
活跃·★ 4.1k·MIT·更新于 2026-11-18
datamodel-code-generator 适合已经拥有数据规范、想把它变成 Python 模型的团队。例如智能体工具返回一张工单,需要稳定的字段、枚举和嵌套结构;通过代码生成可以减少反复手写模型的工作,让修改从同一份 schema 开始。
本次最值得注意的结果是:生成成功不代表所有输出类型都有同样的运行时行为。Pydantic 模型能拒绝多种非法输入;普通 dataclass 构造器可以接受相同的错误值。默认类型转换和可空性也需要按接口约定显式检查。
2026-11-04,我们使用 datamodel-code-generator 0.88.0、Pydantic 2.14.2 和 Python 3.12.13。输入是自己编写的 JSON Schema draft-07 工单样本,包含必填工单编号、优先级枚举、嵌套申请人、非负重试次数、标签数量限制及禁止额外字段。
阅读完整评测、验证范围与参考资料 →#智能体技能#代码生成#CSV#数据类#数据模型#开发者工具#FastAPI#生成器
01
功能特性
01输入:OpenAPI、JSON Schema、GraphQL、Avro、Protobuf、MCP 定义
02输出:Pydantic v2、dataclass、TypedDict、msgspec
03支持 $ref、allOf、oneOf、anyOf 和枚举
04通过 Pyodide 在浏览器本地运行的在线试用
02
为什么选择它
+生成的 Pydantic 模型拒绝了本次六类必填、枚举、范围、嵌套、额外字段和数组越界输入。
+显式选择输出类型,便于比较带运行校验的 Pydantic 与普通 dataclass 容器。
+禁用时间戳后,本次环境中连续两次生成的文件字节相同。
03
权衡点
!默认可选整数接受显式 null;本样本需加 --strict-nullable,才能拒绝 null 并保留省略时的默认值。
!Pydantic 可能转换输入类型,普通 dataclass 构造器则不执行相同的 schema 限制。
!一个本地 schema 样本不能证明完整一致性、远程引用或其他格式兼容性。
05
维护状况检查
活跃检查日期: 2026-11-10
- 最近提交
- 2026-11-10
- 近 90 天提交数
- 100+
- 近 90 天发布数
- 23
- 最新发布
- 0.92.0 (2026-11-10)
- 未关闭 issue
- 93
- 近期 issue 至少有一条评论的比例
- 1/18
近 12 周每周提交数
最早的一周在左边,最近 4 周为橙色。数据来源:GitHub 提交统计。
状态规则:GitHub 上已归档 = 已归档;最近提交在 90 天内 = 活跃;91 到 365 天 = 放缓;更久 = 停滞。所有数字来自所示日期的 GitHub API。
讨论最多的未关闭 issue
- #2022 Add Swift codable structs support7 条评论 · 2024-06-30
- #2775 Migrate to Ruff as the default formatter for improved performance3 条评论 · 2025-12-24
- #419 SQL DDL as source input3 条评论 · 2021-04-28
- #3658 Support ATProto lexicons as input2 条评论 · 2026-07-26
- #3058 Option to not install formatters2 条评论 · 2026-03-18
issue 标题引自 GitHub。请打开链接确认该问题是否仍适用于你使用的版本。
04
适合谁
适合选它的情况
- 已有数据规范,希望可重复地生成 Python 数据模型。
- 能够按接口约定检查校验、类型转换、省略和 null。
建议换别的情况
- 领域数据约定尚未定义,希望生成器代替团队作决定。
- 期待所有输出类型自动执行完全相同的运行校验。
06
兼容性
Python
要求 3.10 及以上,本次使用并面向 3.12
已通过文档验证
Pydantic
本次 v2 输出使用 2.14.2 验证
已通过文档验证
07
快速开始
1
$ python -m pip install datamodel-code-generator==0.88.0
08
使用场景
↳根据 OpenAPI 规范生成带类型的 Python 模型
↳把 JSON 样例转成 Pydantic 模型
09
同类工具
评论
登录后发表评论
暂无评论,来发表第一条吧