JD

JSON 转 Dart 类

Flutter 数据模型,fromJson/toJson 一键生成

类型自动推断:字符串→String、整数→int、小数→double、布尔→bool、嵌套对象与数组也会生成对应的类和 List 类型。


            

如何使用本工具

  1. 粘贴 JSON 或点「载入示例」,支持对象或对象数组。
  2. 填根类名(默认 User),按需开关空安全与注释。
  3. 右侧生成 Dart 类:字段、类型、fromJson 工厂、toJson 方法一应俱全。
  4. 嵌套对象和对象数组会额外生成对应的类。
  5. 复制或下载 .dart 文件,粘贴进 Flutter 项目即可。

常见问题

Q:生成的类能直接用吗?

A:基本可以。字段、类型、fromJson/toJson 都生成好了。如果项目用了 json_serializable 或 freezed 等代码生成框架,风格可能不同;这个工具生成的是纯 Dart 类,不依赖任何第三方包。

Q:空安全选项是什么?

A:勾选后,fromJson 里对每个字段做 null 判断,值为 null 时赋 null(字段类型需为可空,如 String?)。不勾选则直接强转,遇到 null 会抛异常。Dart 2.12+ 默认开启空安全,建议勾选后按需把字段类型改成可空。

Q:嵌套对象怎么处理?

A:每个嵌套对象会生成一个独立的类,数组里的对象会生成「类名+Item」的类。根对象用你填的根类名。fromJson 会递归调用子类的 fromJson。

Q:字段名不符合 Dart 命名规范怎么办?

A:工具会把字段名转成小驼峰(lowerCamelCase),遇到 class、if 等 Dart 关键字会自动加 Val 后缀避开。JSON 里的原始键名仍保留在 fromJson/toJson 的映射里,不影响数据对应。

Q:数字类型怎么判断?

A:JSON 里没有小数点的整数推断为 int,带小数的推断为 double。如果某个字段有时是整数有时是小数,建议手动把它改成 num 或 double,避免运行时类型不匹配。

Q:数据会上传吗?

A:不会。转换全在浏览器本地完成,没有任何网络请求。