Unity存储小能手：PlayerPrefs指南

最新推荐文章于 2025-10-29 20:48:01 发布

原创

最新推荐文章于 2025-10-29 20:48:01 发布 · 1.6k 阅读

25 ·

CC 4.0 BY-SA版权

文章标签：

#unity #游戏引擎

Unity是一款功能强大的游戏开发引擎，提供了许多工具来简化开发过程。其中，PlayerPrefs 是一个简单易用的类，专门用于存储和检索游戏中的小型数据，例如玩家的设置、游戏进度或偏好。

在游戏开发中，我们经常需要保存一些简单的数据，比如：

玩家的音量设置
游戏的最高分数
用户输入的昵称
是否开启特效或背景音乐

这些数据通常不需要复杂的数据库来管理，而 Unity 的 PlayerPrefs 提供了一个轻量级的解决方案。它允许开发者以键值对的形式存储数据，支持跨平台使用，并且操作简单，无需手动处理文件读写。

基本概念

什么是 PlayerPrefs？

PlayerPrefs 是 Unity 提供的一个静态类，用于在本地存储和读取小型数据。它的工作方式类似于键值对存储系统，你可以通过一个“键”（key）来保存或获取对应的“值”（value）。这些数据会被持久化到本地文件中，方便下次启动游戏时读取。

PlayerPrefs 支持以下三种数据类型：

int：整数，例如分数或关卡编号。
float：浮点数，例如音量或时间。
string：字符串，例如玩家名称。

这些类型已经可以满足大多数小型数据存储的需求。

数据存储在哪里？

PlayerPrefs 会将数据保存在本地，具体位置取决于运行的平台：

Windows: 注册表 HKCU\Software\[公司名称]\[产品名称]
macOS: ~/Library/Preferences/[bundle identifier].plist
Linux: ~/.config/unity3d/[公司名称]/[产品名称]
iOS: 应用沙盒中的 NSUserDefaults
Android: /data/data/[包名]/shared_prefs/[包名].xml

开发者无需关心这些细节，Unity 会自动处理跨平台的兼容性。

主要限制

存储容量有限：不适合存储大量数据（不要超过1MB）
安全性低：数据以明文存储，容易被修改
数据类型有限：只支持3种基本类型
无跨设备同步：数据只保存在本地

API 详解

PlayerPrefs 的接口非常简单，以下是它的主要方法：

数据存储方法

// 存储整数值
PlayerPrefs.SetInt(string key, int value);

// 存储浮点数值
PlayerPrefs.SetFloat(string key, float value);

// 存储字符串值
PlayerPrefs.SetString(string key, string value);

数据读取方法

// 读取整数值（带默认值）
int PlayerPrefs.GetInt(string key, int defaultValue = 0);

// 读取浮点数值（带默认值）
float PlayerPrefs.GetFloat(string key, float defaultValue = 0.0f);