Flutter中无需!运算符访问AsyncSnapshot嵌套属性的方法

以下几种方案可以替代!运算符，安全访问AsyncSnapshot的数据：

1. 局部变量接收数据 #

通过将snapshot.data赋值给局部变量，让Dart的类型推断自动识别数据非空，避免空安全报错：

FutureBuilder<List<String>>(
  future: fetchData(),
  builder: (context, snapshot) {
    if (snapshot.hasData) {
      final data = snapshot.data; // 自动推断为非空的List<String>
      return ListView.builder(
        itemCount: data.length,
        itemBuilder: (context, index) => Text(data[index]),
      );
    }
    // 处理加载/错误状态
    return const CircularProgressIndicator();
  },
)

2. 使用AsyncSnapshot.when方法 #

利用when方法统一处理数据、加载、错误三种状态，传入的data参数已确保非空：

FutureBuilder<List<String>>(
  future: fetchData(),
  builder: (context, snapshot) {
    return snapshot.when(
      data: (data) => ListView.builder(
        itemCount: data.length,
        itemBuilder: (context, index) => Text(data[index]),
      ),
      loading: () => const CircularProgressIndicator(),
      error: (error, stackTrace) => Text('请求失败：$error'),
    );
  },
)

3. Dart 3.0+ 模式匹配（Guard模式） #

通过模式匹配在判断非空的同时完成赋值，data自动为非空类型：

FutureBuilder<List<String>>(
  future: fetchData(),
  builder: (context, snapshot) {
    if (snapshot.data case final data?) {
      return ListView.builder(
        itemCount: data.length,
        itemBuilder: (context, index) => Text(data[index]),
      );
    }
    return const CircularProgressIndicator();
  },
)

4. 让Future返回非空默认值 #

调整异步请求逻辑，确保Future始终返回非空数据（比如出错时返回空列表），从根源避免snapshot.data为null：

// 异步请求方法
Future<List<String>> fetchData() async {
  try {
    final response = await http.get(Uri.parse('your_api_url'));
    return parseResponse(response.body); // 解析数据为List<String>
  } catch (e) {
    // 出错时返回空列表，保证Future永远返回非空值
    return [];
  }
}

// FutureBuilder中直接访问数据
FutureBuilder<List<String>>(
  future: fetchData(),
  builder: (context, snapshot) {
    final data = snapshot.data!; // 此时data必然非空
    return ListView.builder(
      itemCount: data.length,
      itemBuilder: (context, index) => Text(data[index]),
    );
  },
)

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