iOS Model Generator - 让 JSON 转模型变得简单高效

iOS Model Generator - 让 JSON 转模型变得简单高效

在 iOS 开发中，手写 JSON 转 Model 的工作总是繁琐而耗时。虽然已有 JSONExport 等工具，但某些功能仍无法满足我的需求。因此，我决定开发一款更符合 iOS 开发者使用习惯的工具——iOS Model Generator。


由于是抽空开发，目前仍处于验证优化阶段，基础功能已实现，但尚未进行全面测试。若数据结构不复杂，生成的模型应该没有问题，欢迎大家试用体验。

当前状态：验证优化阶段
如有任何问题，请通过工具页面的联系我功能发送邮件，并附上您使用的 JSON 数据/结构以及遇到的问题描述，我会及时优化处理。

---

🌐 为什么选择网页版？

最初计划开发原生 macOS 版本，但考虑到多设备协作、免安装、即开即用的便利性，最终决定采用 Web 前端实现。所有转换算法均在浏览器中运行，无需安装，打开即用，且数据不会上传到服务器，保障隐私安全。

---

🎯 与其他工具的差异化亮点

1. 智能数据结构化 + 动态字段选择

① 结构化展示

JSON 数据会以清晰的树形结构展示，生成的模型自带基础字段注释，一目了然。

② 动态选择所需层级

传统工具如果仅需部分数据层级做模型，需要手动复制子层级 JSON，本工具只需点击对应节点，即可针对特定数据层（如 data）生成模型。

针对所选层级制作模型

③ 智能处理多层嵌套的相同结构

对于数据在不同层级,但结构相同的数据，工具会自动识别并提示三种处理方案：

• 视为同一 Model：复用已有模型
• 制作基类：创建基类模型（Objective-C）
• 视为不同 Model：分别生成独立模型

对于 Swift 的 Struct，当选择「制作基类」时会自动生成 协议文件，实现类似继承的效果。

iOS Model Generator多层数据展示

2. 完善的 null 值处理

部分工具在遇到 JSON 中的 null 值时会出现转换失败。本工具在转换时会智能处理：

• Objective-C 模式：null 值字段默认生成 NSObject 类型
• Swift 模式：null 值字段默认生成 Any 类型

同时提供 「过滤空数据」 配置选项（默认开启）：

• 关闭时：直接为 null 字段生成对应类型（NSObject/Any）
• 开启时：会将空值字段以注释形式保留，便于后续数据完整时修改

3. 灵活的模型配置

① 实时自定义 Model 名称

修改 Model 名称后，代码实时更新，无需重复点击生成。

模型名修改

② 多框架支持（Objective-C）

• 原生实现
• MJExtension 框架支持
  

③ 空值安全配置

无论 Swift 还是 Objective-C，均可设置是否允许 null 值，并配置默认值。在模型转换时如服务器发来null时会自动使用默认值进行赋值，提前规避因空值导致的异常或崩溃。

4. 便捷的代码获取方式

① 一键复制粘贴

可直接复制单个模型的代码，粘贴到项目中。

② 批量下载

支持一键打包下载所有模型文件。

③ 瀑布流预览

当生成文件较多时，可通过瀑布流形式查看所有文件内容。

🚀 快速开始

1. 访问 iOS Model Generator 网页
2. 粘贴 JSON 数据
3. 根据需要选择生成模式（Swift/OC）和配置选项
4. 点击生成并下载/复制代码

---

📝 注意事项

• 目前工具仍处于 验证优化阶段，建议生成后简单检查代码
• 如遇复杂嵌套结构，建议分步生成模型
• 欢迎反馈使用中的任何问题

---

🎉 结语

虽然 iOS Model Generator 尚未经过大规模实际项目测试，但其设计初衷是解决iOS 开发者在 JSON 转 Model 过程中的痛点。如果您在试用过程中发现任何问题或有改进建议，欢迎随时联系反馈。

感谢您的关注与试用！