Flutter使用SharedPreferences获取List<String>及类型不兼容问题修复

SharedPreferences 的所有读取、写入方法，第一个入参都要求是String类型的存储键（key），用来匹配之前存数据时绑定的标识。你现在的代码存在参数错位的问题：

• 保存数据时，你硬编码把存储键设为字符串"id"，把List类型的favId作为对应的值写入了本地存储
• 读取数据时，你把本身是List类型的favId变量直接当成存储键传给了pref.getStringList()，方法收到的入参是List<String>，但要求的入参是String，直接触发“List不是String子类型”的运行时报错。

• 统一抽离存储键常量：不要在保存、读取代码里分别硬编码key，把固定的存储标识抽成独立常量，从根源避免两边写不一致的问题
• 修正getData的入参逻辑：读取方法不需要把favId本身当入参传，只需要传入固定的存储键就能拉取对应的数据
• 补全状态更新逻辑：页面初始化拿到读取结果后，必须通过setState把数据赋值给页面的变量，才能让UI正常加载展示
• 加空值兜底逻辑：本地从未存过对应数据时，getStringList会返回null，要设置默认空列表，避免后续业务逻辑报空指针

首先抽离统一的存储常量，避免散写出错：

// 全局统一的收藏id存储键
static const String _favIdKey = "id";

修正后的保存方法：

void saveData() async {
  SharedPreferences pref = await SharedPreferences.getInstance();
  // 传入统一的存储键，把favId列表作为值写入
  await pref.setStringList(_favIdKey, favId);
}

修正后的读取方法：

// 明确标注返回值类型，让IDE提前拦截类型不匹配问题
Future<List<String>> getData() async {
  SharedPreferences pref = await SharedPreferences.getInstance();
  // 没有历史存储数据时返回空列表兜底
  return pref.getStringList(_favIdKey) ?? [];
}

适配initState的页面初始化读取逻辑：

@override
void initState() {
  super.initState();
  // 页面打开时触发数据读取
  _loadSavedFavData();
}

void _loadSavedFavData() async {
  // 异步等待读取到本地存储的列表数据
  List<String> savedIds = await getData();
  // 更新页面状态，刷新UI展示
  setState(() {
    favId = savedIds;
  });
}

• 永远不要把要存储的业务值（比如这里的favId列表）和存储键搞混，所有SharedPreferences操作的第一位入参，永远是String类型的key
• 本地存储是异步操作，不要把异步方法的返回值当同步结果直接使用，必须通过await拿到结果后再做状态更新
• 给所有自定义方法加上明确的返回值类型标注，能在开发阶段就暴露类型不匹配的问题，减少运行时崩溃的概率

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