json_serializable继承场景下未自动导入依赖类的编译错误求助

这是json_serializable处理继承场景时的已知行为，并非你的实现有误。

错误根源在于：生成的foo.g.dart代码中直接调用了Baz.fromJson，但foo.dart未显式导入Baz类。尽管父类Bar导入了Baz，但Dart的导入是文件级别的——foo.g.dart仅关联foo.dart的导入列表，不会继承父类文件的导入，因此编译时无法识别Baz。静态分析未检测到问题，是因为IDE会通过父类的间接导入识别类型，但编译器严格遵循文件导入规则。

以下两种方案均无需手动在foo.dart中添加Baz的导入，适合大型项目维护：

1. 启用explicitToJson参数（推荐） #

在父类Bar和子类Foo的@JsonSerializable注解中添加explicitToJson: true，生成的代码会通过父类的序列化方法处理baz字段，而非直接调用Baz.fromJson。

修改bar.dart：

import 'package:app_core/model/baz.dart';
import 'package:app_core/repository_helper/json_map.dart';
import 'package:app_core/utils/annotations/annotations.dart';

part 'bar.g.dart';

@JsonSerializable(explicitToJson: true)
class Bar {
  final Baz baz;

  Bar({required this.baz});

  factory Bar.fromJson(JsonMap json) => _$BarFromJson(json);

  JsonMap toJson() => _$BarToJson(this);
}

修改foo.dart：

import 'package:app_core/model/bar.dart';
import 'package:app_core/repository_helper/json_map.dart';
import 'package:app_core/utils/annotations/annotations.dart';

part 'foo.g.dart';

@JsonSerializable(explicitToJson: true)
class Foo extends Bar {
  final String id;

  Foo({
    required this.id,
    required super.baz,
  });

  factory Foo.fromJson(JsonMap json) => _$FooFromJson(json);

  JsonMap toJson() => _$FooToJson(this);
}

重新运行build_runner后，生成的foo.g.dart会通过_$BarFromJson处理父类字段，不再直接引用Baz，自然无需额外导入。

2. 模块内共享导入（耦合性较高） #

若所有类属于同一模块，可通过part of让foo.dart共享bar.dart的导入，但这种方式耦合性强，仅适合小型模块：
在bar.dart顶部添加：

part of 'foo.dart';

注意json_map.dart中的语法错误：Map<string, dynamic>需改为Map<String, dynamic>（String首字母大写），否则会引发其他序列化异常。

内容的提问来源于stack exchange，提问作者TSR