Java中读取配置文件最常用、最轻量的方式是使用java.util.Properties类,它原生支持键值对格式的加载、修改和保存,无需额外依赖;可通过类路径、文件路径、URL或字符串加载,需注意编码(推荐UTF-8)及生产环境写入风险。

Java中读取配置文件最常用、最轻量的方式就是使用java.util.Properties类,它专为键值对格式(如key=value)的文本配置文件设计,无需额外依赖,原生支持加载、修改和保存。
Properties基础用法:从文件加载配置
Properties本质是一个继承自Hashtable的类,内部以字符串为键和值。读取配置前需确保配置文件(如app.properties)位于类路径下或指定路径中。
常见做法是通过ClassLoader.getResourceAsStream()加载类路径下的文件:
- 创建
Properties实例 - 调用
load(InputStream)方法传入输入流 - 使用
getProperty(String key)获取对应值,可提供默认值避免返回null
示例代码:
立即学习“Java免费学习笔记(深入)”;
app.propertiesdb.url=jdbc:mysql://localhost:3306/mydb db.username=root db.password=123456Java代码
Properties props = new Properties();
try (InputStream is = getClass().getClassLoader().getResourceAsStream("app.properties")) {
if (is == null) throw new RuntimeException("配置文件未找到");
props.load(is);
}
String url = props.getProperty("db.url");
String user = props.getProperty("db.username", "guest"); // 提供默认值
支持多种加载方式:文件路径、URL、资源流
除了类路径加载,Properties也支持从绝对/相对文件路径、URL甚至字节数组加载,适应不同部署场景。
- 从文件路径加载:
new FileInputStream("config/app.properties") - 从URL加载:
new URL("file:///opt/conf/app.properties").openStream() - 从字符串加载(适合动态配置):
load(new StringReader("key=value"))
注意:使用文件路径时需处理FileNotFoundException;从URL加载要注意协议支持(如file://、http://);生产环境推荐优先使用类路径或标准配置目录(如conf/),便于打包管理。
编码与中文乱码问题处理
Properties默认按ISO-8859-1编码读取,若配置文件含中文,直接保存会导致乱码。解决方式有两种:
-
推荐方式:使用
load(Reader)重载方法,配合InputStreamReader指定UTF-8编码 -
兼容方式:保持
load(InputStream),但将中文写成Unicode转义(如\u4f7f\u7528\u6237),可用native2ascii工具转换
更简洁的UTF-8加载示例:
try (InputStream is = getClass().getClassLoader().getResourceAsStream("app.properties");
Reader reader = new InputStreamReader(is, StandardCharsets.UTF_8)) {
props.load(reader);
}
进阶技巧:动态更新与保存配置
Properties不仅可读,还能在运行时修改并写回文件,适用于简单运行时配置调整(如开关控制、限流阈值)。
- 修改值:
props.setProperty("log.level", "DEBUG") - 保存到文件:
store(OutputStream, comment)或store(Writer, comment) - 保存时支持注释和时间戳(自动添加)
示例:
props.setProperty("feature.enabled", "true");
try (FileOutputStream fos = new FileOutputStream("app.properties")) {
props.store(fos, "Updated by Java at " + new Date());
}
注意:频繁写配置文件可能引发IO竞争或覆盖风险,生产环境建议仅用于低频、非关键配置;高并发场景应结合配置中心(如Nacos、Apollo)。










