Dart单例类报'_instance未初始化'错误，如何初始化或规避空安全问题？

报错根源 #

你当前的写法和Dart空安全规则冲突，触发报错的核心原因有两个：

• 你为_instance声明的是late修饰的非空类型ShoppingBasketData，该类型本身不可能等于null，你写的if (_instance == null)判空逻辑完全无效
• late修饰的变量如果在未完成赋值的状态下被访问，就会直接抛出Field '_instance' has not been initialized的运行时错误

正确实现方案 #

方案1：最小改动适配现有逻辑 #

把_instance改为可空类型即可让判空逻辑生效，代码如下：

class ShoppingBasketData{ 
  // 改为可空类型，初始值默认是null
  static ShoppingBasketData? _instance;
  
  // 这里可以直接初始化，省掉构造函数赋值逻辑
  List<product> _basketItem = <product>[];

  // 私有构造函数，禁止外部随意实例化，单例的必要约束
  ShoppingBasketData._internal();

  List<product> get basketItem => _basketItem;

  set basketItem(List<product> value) {
    _basketItem = value;
  }

  static ShoppingBasketData getInstance(){
    // 可空类型的判空逻辑合法
    if (_instance == null){
      _instance  = ShoppingBasketData._internal();
    }
    // 已提前判空，直接用!断言非空即可
    return _instance!;
  }
}

方案2：更符合Dart规范的工厂构造单例 #

用工厂构造函数替代显式的getInstance方法，调用更自然：

class ShoppingBasketData{ 
  static ShoppingBasketData? _instance;
  List<product> _basketItem = <product>[];

  ShoppingBasketData._internal();

  factory ShoppingBasketData() {
    _instance ??= ShoppingBasketData._internal();
    return _instance!;
  }

  List<product> get basketItem => _basketItem;

  set basketItem(List<product> value) {
    _basketItem = value;
  }
}
// 调用时直接写ShoppingBasketData()即可获取单例

方案3：无判空的极简写法（官方推荐） #

Dart的静态变量默认是懒加载的，因此不需要手动写判空逻辑，编译期就能保证空安全，完全规避未初始化报错：

class ShoppingBasketData{ 
  // 静态初始化时直接调用私有构造赋值，非空类型无需判空
  static final ShoppingBasketData _instance = ShoppingBasketData._internal();
  List<product> _basketItem = <product>[];

  ShoppingBasketData._internal();

  factory ShoppingBasketData() => _instance;

  List<product> get basketItem => _basketItem;

  set basketItem(List<product> value) {
    _basketItem = value;
  }
}

额外优化建议 #

• 单例类一定要把构造函数改为私有（加_internal后缀），避免外部被意外实例化破坏单例特性
• 不需要延迟初始化的属性不要加late修饰，直接声明时赋值即可，减少运行时异常风险

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