shared_preferences 是 Flutter 中一个非常常用的插件，用于在本地存储简单的键值对数据。它通常用于存储用户偏好设置、应用配置等小量数据。下面是如何使用 shared_preferences 插件的详细步骤。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 shared_preferences 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  shared_preferences: ^2.0.6  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 导入插件

在需要使用 shared_preferences 的 Dart 文件中导入插件：

import 'package:shared_preferences/shared_preferences.dart';

3. 写入数据

你可以使用 SharedPreferences 实例来存储数据。以下是一些常见数据类型的存储示例：

// 存储字符串
Future<void> saveString() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setString('key_string', 'Hello, Flutter!');
}

// 存储整数
Future<void> saveInt() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setInt('key_int', 42);
}

// 存储布尔值
Future<void> saveBool() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setBool('key_bool', true);
}

// 存储浮点数
Future<void> saveDouble() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setDouble('key_double', 3.14);
}

// 存储字符串列表
Future<void> saveStringList() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.setStringList('key_string_list', ['Flutter', 'Dart', 'Firebase']);
}

4. 读取数据

你可以使用 SharedPreferences 实例来读取之前存储的数据：

// 读取字符串
Future<String?> readString() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  return prefs.getString('key_string');
}

// 读取整数
Future<int?> readInt() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  return prefs.getInt('key_int');
}

// 读取布尔值
Future<bool?> readBool() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  return prefs.getBool('key_bool');
}

// 读取浮点数
Future<double?> readDouble() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  return prefs.getDouble('key_double');
}

// 读取字符串列表
Future<List<String>?> readStringList() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  return prefs.getStringList('key_string_list');
}

5. 删除数据

你可以使用 SharedPreferences 实例来删除存储的数据：

// 删除指定键的数据
Future<void> removeData() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.remove('key_string');
}

// 清空所有数据
Future<void> clearData() async {
  SharedPreferences prefs = await SharedPreferences.getInstance();
  await prefs.clear();
}

6. 完整示例

以下是一个完整的示例，展示了如何使用 shared_preferences 插件来存储和读取数据：

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: SharedPreferencesExample(),
    );
  }
}

class SharedPreferencesExample extends StatefulWidget {
  [@override](/user/override)
  _SharedPreferencesExampleState createState() => _SharedPreferencesExampleState();
}

class _SharedPreferencesExampleState extends State<SharedPreferencesExample> {
  String? storedString;

  [@override](/user/override)
  void initState() {
    super.initState();
    loadData();
  }

  Future<void> loadData() async {
    SharedPreferences prefs = await SharedPreferences.getInstance();
    setState(() {
      storedString = prefs.getString('key_string') ?? 'No data found';
    });
  }

  Future<void> saveData() async {
    SharedPreferences prefs = await SharedPreferences.getInstance();
    await prefs.setString('key_string', 'Hello, Flutter!');
    loadData();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('SharedPreferences Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'Stored Data: $storedString',
              style: TextStyle(fontSize: 20),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: saveData,
              child: Text('Save Data'),
            ),
          ],
        ),
      ),
    );
  }
}