适用版本
记录 2024 年 12 月版 Dart Model Maker 的界面与操作。
Dart Model Maker 把 JSON 样本转换成 Dart 模型类,提供代码预览、类型选项和文件导出。这里记录的是 2024 年 12 月版的操作方式,适合回看这个小工具的设计和使用流程。
界面与输入

左侧三个输入区分别承担不同的工作。
| 输入项 | 用途 |
|---|---|
| 文件名 | 决定导出的 Dart 文件名称,与模型类名分别设置。 |
| Model 根名 | 用于生成根模型的类名,以及相关嵌套模型的命名。 |
| JSON 报文 | 填入需要转换的 JSON;这个版本要求最外层为对象,对应 Dart 的 Map。 |
例如,文件名可以设为 user_profile,Model 根名设为 UserProfile。两者分别面向文件组织和代码中的类型命名,填写时无需保持完全相同。
生成选项
右侧的四个开关控制文件保存和代码生成。
| 选项 | 启用后的行为 |
|---|---|
| 允许文件覆盖 | 控制目标目录已有同名文件时是否允许覆盖。它属于文件保存设置。 |
| 启用类型全 String | 按旧版说明,将 List、Map 之外的字段按 String 类型生成;关闭时根据输入样本推断类型。 |
| final 修饰词 | 为字段添加 final,例如 final String? id。关闭后不添加该修饰词。 |
| ToJson 功能 | 生成把模型转回 Map/JSON 的相关方法。 |
「允许文件覆盖」和「启用类型全 String」分别影响保存行为与字段类型。作者仓库对同名文件覆盖控制有独立说明。Dart Model Maker 项目
预览与导出
- 填写文件名和 Model 根名,粘贴完整的 JSON 对象。
- 根据接口字段的使用方式设置类型、
final和 ToJson 选项。 - 点击「生成预览」,右下方显示生成的 Dart 代码。旧版支持长按该按钮复制代码。
- 点击「生成 Model 文件」,在弹出的窗口选择输出目录,按输入的文件名保存。
模型生成依赖输入样本。样本中缺少的字段、只有空数组的列表,以及一直为 null 的值,都不足以说明完整的接口类型。作者的早期更新记录专门处理过空 List 和 Null 值;把生成结果接入项目时,仍需结合接口约定补全这些情况。项目更新记录
旧版数据处理说明
2024 年 12 月 8 日随应用发布的说明将 JSON 转换与文件生成描述为设备本地处理,文件路径用于读取和保存。该说明适用于当时的 Dart Model Maker 应用;网站及其他软件的数据处理规则,以各自的隐私说明为准。
项目来源
作者:NeverOuO。原使用说明发表于 2024 年 12 月 8 日。


