Flutter中能否仅定义一次SharedPreferences实例并按需调用？

当然可以只初始化一次SharedPreferences并全局复用。你之前的代码问题在于appData是main函数的局部变量，组件树根本访问不到，所以无法生效。下面给你两种实用的实现方式：

方法一：全局变量（简单直接，适合小项目） #

把变量声明在函数外部，用late标记延迟初始化，再在main里完成实例初始化：

import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';

// 全局声明SharedPreferences实例
late SharedPreferences appData;

void main() async {
  // 必须添加这行，异步初始化前需要先绑定Flutter框架
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化全局实例
  appData = await SharedPreferences.getInstance();
  runApp(const MyApp());
}

// 任意组件内直接调用示例
class ProfileWidget extends StatelessWidget {
  const ProfileWidget({super.key});

  @override
  Widget build(BuildContext context) {
    return Text(appData.getString('username') ?? '未登录');
  }
}

方法二：单例类（规范易维护，适合中大型项目） #

封装一个单例服务类，统一管理SharedPreferences的操作，避免全局变量的混乱：

import 'package:shared_preferences/shared_preferences.dart';

class PrefsService {
  // 单例实例，保证全局唯一
  static final PrefsService _singleton = PrefsService._internal();
  late SharedPreferences _prefs;

  // 工厂构造函数，返回单例
  factory PrefsService() => _singleton;

  // 私有构造函数，禁止外部实例化
  PrefsService._internal();

  // 初始化方法
  Future<void> init() async {
    _prefs = await SharedPreferences.getInstance();
  }

  // 封装常用存储方法，示例：存/取字符串
  String? getString(String key) => _prefs.getString(key);
  Future<bool> setString(String key, String value) => _prefs.setString(key, value);

  // 可扩展其他类型操作：int、bool、List<String>等
  bool? getBool(String key) => _prefs.getBool(key);
  Future<bool> setBool(String key, bool value) => _prefs.setBool(key, value);
}

然后在main里完成初始化：

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  // 初始化单例服务
  await PrefsService().init();
  runApp(const MyApp());
}

调用示例：

class SettingsPage extends StatelessWidget {
  const SettingsPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Center(
        child: Text('夜间模式：${PrefsService().getBool('dark_mode') ?? false}'),
      ),
    );
  }
}

注意事项 #

• 两种方式都必须调用WidgetsFlutterBinding.ensureInitialized()，否则异步初始化会触发框架绑定错误
• 确保在使用实例前已经完成初始化（main里的await必须等待初始化完成再调用runApp）

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