Flutter如何让类仅对指定类可见？解决序列化类提示干扰

算力阿峰

2026-7-23

让仅单次使用的JSON序列化类仅对所属类可见

要解决FavouriteFood类频繁出现在代码提示的问题，核心是把它设为仅对User类可见的私有嵌套类，具体实现步骤如下：

修改类结构

将FavouriteFood嵌套到User类内部，并通过下划线前缀标记为库私有，这样外部代码无法访问该类，自然不会出现无关的代码提示。同时保持json_serializable的序列化支持，修改后的代码如下：

@JsonSerializable()
class User {
  final String name;
  final int age;
  final List<_FavouriteFood> favouriteFood;

  const User({
    required this.name = "",
    required this.age = 0,
    required this.favouriteFood = const [],
  });

  // 序列化/反序列化方法
  factory User.fromJson(Map<String, dynamic> json) => _$UserFromJson(json);
  Map<String, dynamic> toJson() => _$UserToJson(this);

  // 私有嵌套类：仅User类内部可见
  @JsonSerializable()
  class _FavouriteFood {
    final int id;
    final String food;

    const _FavouriteFood({
      required this.id = 0,
      required this.food = "",
    });

    // 嵌套类的序列化方法
    factory _FavouriteFood.fromJson(Map<String, dynamic> json) => _$_FavouriteFoodFromJson(json);
    Map<String, dynamic> toJson() => _$_FavouriteFoodToJson(this);
  }
}

关键说明

私有嵌套类：类名前加下划线_后，_FavouriteFood会变成库私有成员，外部代码无法引用，彻底避免无关的代码提示。
序列化兼容性：json_serializable完全支持嵌套类的序列化逻辑，运行代码生成命令（dart run build_runner build）时，会自动生成嵌套类对应的序列化代码。
规范修正：按照Dart代码规范，类名首字母需大写，原代码中的user已修正为User。