Preferences API是很多编程语言和框架中提供的轻量级持久化工具，主要用于存储少量的键值对配置数据，不需要依赖外部数据库，适合保存用户偏好、应用基础设置等简单变量，实现配置的持久化存储。
Preferences API的核心特点
Preferences API的设计目标就是简化简单配置的存储流程，主要有以下几个特点：
- 轻量级：不需要额外安装数据库服务，数据存储在本地文件或系统注册表中，占用资源极少
- 键值对结构：数据以key-value形式存储，读取和写入操作都非常简单，不需要复杂的查询语句
- 持久化：数据会保存在本地存储介质中，应用重启后数据不会丢失
- 跨平台适配：很多实现会根据不同操作系统自动选择适配的存储方式，开发者不需要处理平台差异
Java中Preferences API的基础用法
Java标准库自带了Preferences API，位于java.util.prefs包下，分为用户偏好和系统偏好两种存储范围，下面以用户偏好为例介绍基本操作。
写入配置数据
首先获取Preferences实例，然后调用put方法写入键值对数据，代码如下：
import java.util.prefs.Preferences;
public class PrefsDemo {
public static void main(String[] args) {
// 获取用户节点的Preferences实例，参数为当前类的class对象
Preferences prefs = Preferences.userNodeForPackage(PrefsDemo.class);
// 写入字符串类型的配置
prefs.put("username", "test_user");
// 写入整数类型的配置
prefs.putInt("max_login_count", 5);
// 写入布尔类型的配置
prefs.putBoolean("auto_login", true);
System.out.println("配置写入完成");
}
}
读取配置数据
读取数据时同样先获取Preferences实例，然后根据存储的类型调用对应的get方法，还可以设置默认值，避免key不存在时返回空值：
import java.util.prefs.Preferences;
public class PrefsReadDemo {
public static void main(String[] args) {
Preferences prefs = Preferences.userNodeForPackage(PrefsReadDemo.class);
// 读取字符串配置，第二个参数为默认值
String username = prefs.get("username", "default_user");
// 读取整数配置
int maxLoginCount = prefs.getInt("max_login_count", 3);
// 读取布尔配置
boolean autoLogin = prefs.getBoolean("auto_login", false);
System.out.println("用户名：" + username);
System.out.println("最大登录次数：" + maxLoginCount);
System.out.println("自动登录：" + autoLogin);
}
}
删除配置数据
如果需要移除某个配置项，可以调用remove方法，删除所有配置可以调用removeNode方法：
import java.util.prefs.Preferences;
public class PrefsDeleteDemo {
public static void main(String[] args) {
Preferences prefs = Preferences.userNodeForPackage(PrefsDeleteDemo.class);
// 删除单个配置项
prefs.remove("auto_login");
// 删除当前节点的所有配置，谨慎使用
// prefs.removeNode();
System.out.println("配置删除完成");
}
}
使用Preferences API的注意事项
虽然Preferences API使用简单，但也有一些限制需要注意：
- 存储容量有限：不同系统对单个Preferences节点的存储大小有不同限制，通常不适合存储大体积数据，比如文件内容、大量日志等
- 不适合敏感数据：Preferences API存储的数据通常是明文保存的，不要用来存储密码、token等敏感信息，避免安全风险
- key命名规范：建议使用包名类似的层级命名方式，避免不同模块的配置key冲突，比如使用com_example_module_config_username这样的格式
- 并发问题：如果是多线程操作同一个Preferences实例，需要注意并发安全，避免同时写入导致数据异常
适用场景总结
Preferences API适合以下场景使用：
| 场景类型 | 说明 |
|---|---|
| 用户偏好设置 | 比如主题选择、字体大小、是否开启通知等用户个性化配置 |
| 应用基础配置 | 比如窗口位置、上次打开的文件路径、默认保存目录等应用运行参数 |
| 简单状态记录 | 比如是否是首次启动应用、上次登录时间等简单状态标记 |
当你的应用只需要存储少量简单配置变量，不需要复杂的查询和关联能力时，Preferences API是非常合适的轻量级持久化方案，能大幅减少开发成本，避免引入不必要的依赖。
Preferences_API变量配置持久化轻量级存储修改时间：2026-07-15 06:30:29