Flutter技术问询：如何实现SharedPreferences的同步使用？

这个思路其实很常见也完全可行——把SharedPreferences实例提前初始化并作为类字段持有，确实能避免每次调用都写async/await的繁琐。不过要注意几个容易踩坑的点，帮你梳理一下：

• 初始化时机一定要早且确保完成
  你需要在应用启动的最早期完成初始化，比如在main函数里先执行初始化，再运行runApp。举个实际的代码例子：

  late SharedPreferences sp;
  
  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    sp = await SharedPreferences.getInstance();
    runApp(const MyApp());
  }
  

  这里必须加上WidgetsFlutterBinding.ensureInitialized()，不然在Flutter核心框架初始化完成前调用平台通道（SharedPreferences依赖这个能力）会直接报错。如果是通过构造函数传入实例，也要确保传入的是已经初始化完成的对象，不能传一个未完成的Future。

• 空安全的细节处理
  如果用的是空安全版本的Flutter，一定要保证你的sp字段不会出现null的情况。可以用late关键字（像上面的例子）提前声明，或者在UI层用FutureBuilder等待初始化完成后再渲染内容，避免在初始化完成前同步调用sp的方法导致空指针异常。

• 状态管理场景下的优化方式
  如果你用Provider、Riverpod这类状态管理工具，更推荐把SharedPreferences实例作为依赖注入进去，而不是用全局变量。比如在Riverpod里可以这么写：

  final sharedPreferencesProvider = Provider<SharedPreferences>((ref) {
    throw UnimplementedError('SharedPreferences not initialized');
  });
  
  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    final sp = await SharedPreferences.getInstance();
    runApp(
      ProviderScope(
        overrides: [
          sharedPreferencesProvider.overrideWithValue(sp),
        ],
        child: const MyApp(),
      ),
    );
  }
  

  这样在各个页面或ViewModel里就能同步获取实例使用，依赖关系更清晰，还方便后续做测试（可以轻松mock SharedPreferences实例）。

• 异常处理不能忽略
  SharedPreferences.getInstance()是可能抛出异常的——比如平台层面的错误、存储权限不足等。所以初始化的时候一定要加try-catch逻辑，避免应用直接崩溃：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    try {
      sp = await SharedPreferences.getInstance();
    } catch (e) {
      // 这里可以做降级处理，比如使用默认配置，或者给用户弹出提示
      print('初始化SharedPreferences失败: $e');
    }
    runApp(const MyApp());
  }
  

• 禁止在初始化完成前同步调用
  不管是全局变量还是类字段，一定要确保调用sp.getString()等方法前，sp已经完成初始化。如果你的应用有启动页，可以在启动页等待初始化完成后再跳转到主页面，这样主页面里就能放心同步调用了。

总的来说，这个方案是完全可行的，只要把以上几个细节处理好，就能替代每次异步调用的写法，让代码更简洁流畅。

内容的提问来源于stack exchange，提问作者Marcin Szałek