Unity PlayerPrefs

何为 PlayerPrefs

在Unity ScriptableObject 一文中我们提及了SO可以搭配PlayerPrefs来进行变更数据的持久化，那么什么是PlayerPrefs呢？
PlayerPrefs 是 Unity 提供的一个轻量级本地数据存储系统，用于在游戏运行时保存和读取玩家的偏好设置。它本质上是一个键值对(Key-Value)存储，数据会持久化保存在玩家设备的本地文件中。

PlayerPrefs 的数据存储在哪里？

PlayerPrefs 的基本API

写入数据

// 保存整数
PlayerPrefs.SetInt("Score", 100);

// 保存浮点数
PlayerPrefs.SetFloat("Volume", 0.8f);

// 保存字符串
PlayerPrefs.SetString("PlayerName", "张三");

// 立即写入磁盘（可选，不调用也会在游戏退出时自动保存）
PlayerPrefs.Save();

读取数据

// 读取整数（如果不存在，返回默认值 0）
int score = PlayerPrefs.GetInt("Score");

// 读取浮点数（如果不存在，返回默认值 0.0f）
float volume = PlayerPrefs.GetFloat("Volume");

// 读取字符串（如果不存在，返回空字符串 ""）
string name = PlayerPrefs.GetString("PlayerName");

// 带默认值的读取（推荐！）
int score = PlayerPrefs.GetInt("Score", 50);      // 不存在时返回 50
float volume = PlayerPrefs.GetFloat("Volume", 1.0f);
string name = PlayerPrefs.GetString("PlayerName", "默认玩家");

检查与删除

// 检查某个键是否存在
if (PlayerPrefs.HasKey("Score"))
{
    // 存在则读取
    int score = PlayerPrefs.GetInt("Score");
}

// 删除单个键
PlayerPrefs.DeleteKey("Score");

// 删除所有数据
PlayerPrefs.DeleteAll();

实际应用场景 & 使用

1. 保存游戏设置（推荐配合ScriptableObject来使用哦）：用SO作为运行时内存数据，方便各系统引用、PlayerPrefs作为持久化存储，负责保存和加载；
2. 保存游戏进度、存档、删档；
3. 不需要每次 Set 后都调用 Save()，会降低性能，而是在保存所有数据后统一调用一次即可。

注意事项 与 局限性

PlayerPrefs VS 其他存储方案