工具说明与 Dart (Flutter) 数据模型知识点

工具特点

• 全自动手动解析 (Manual)：能够深度遍历并解析嵌套对象和嵌套数组，生成绝对安全、不依赖任何第三方库的 fromJson 和 toJson 工厂方法。这特别适合中小型项目或者不希望引入构建工具的场景。
• json_serializable 支持：对于大型 Flutter 项目，如果使用了 json_serializable，工具会自动为你添加 part 指令和 @JsonKey 等注解代码，让你只需要运行 build_runner 即可。
• 健全空安全 (Null Safety)：全面支持 Dart 2.12 引入的健全空安全。当开启后，所有属性均会附加 ? 可空标记，防止接口脏数据导致应用在运行时抛出红屏。

Dart 里的 Factory (工厂构造函数)

• factory 关键字：在 Dart 中，factory ClassName.fromJson(...) 是非常经典的 JSON 实例化写法。工厂构造函数允许我们在方法体中进行复杂的解析与判断，并且最后返回一个新的类实例（或从缓存中返回实例）。
• final 修饰符：在 Flutter 状态管理中（尤其是配合 Provider 或 Bloc），数据模型应当是不可变的（Immutable）。因此工具默认使用 final 修饰所有字段。