properties最轻量稳妥,适合纯本地键值配置,但不支持嵌套和注释;需用getresourceasstream()读取classpath资源,注意编码(java 9+用load(reader),java 8用inputstreamreader指定utf-8),避免重复load导致键值污染,复杂需求应换用apache commons configuration等增强工具。

Java 里用 Properties 读配置文件最轻量、最稳妥,适合无依赖、纯本地键值场景,但别指望它支持嵌套或注释渲染。
用 Properties.load(InputStream) 读取 classpath 下的配置文件
这是最常用路径:把 config.properties 放进 src/main/resources,然后用类加载器获取流:
Properties props = new Properties();
try (InputStream is = MyClass.class.getClassLoader().getResourceAsStream("config.properties")) {
if (is == null) throw new RuntimeException("config.properties not found");
props.load(is);
}
String dbUrl = props.getProperty("db.url");
- 必须用
getResourceAsStream(),不能用FileInputStream直接读路径——打包成 jar 后文件不在文件系统里 -
props.getProperty("key")返回null表示键不存在,不会抛异常;建议配合默认值用getProperty("key", "default") - 不自动处理空格:键和值首尾空格会被保留,必要时自己
trim()
注意 Properties 的编码限制:默认 ISO-8859-1
如果你的配置文件含中文,又没声明编码,load(InputStream) 会乱码。Java 9+ 提供了 load(Reader) 替代方案:
try (Reader reader = new InputStreamReader(
MyClass.class.getClassLoader().getResourceAsStream("config.properties"),
StandardCharsets.UTF_8)) {
props.load(reader);
}
- Java 8 及更早版本没有
load(Reader)重载,必须用load(new InputStreamReader(is, "UTF-8")),且需捕获UnsupportedEncodingException - 不要依赖 IDE 自动保存为 UTF-8 就万事大吉——
Properties不识别 BOM,也不解析# encoding=UTF-8这类伪指令
避免直接 new Properties 后反复 load() 引发内存泄漏
每次 load() 都会把新键值对 put 进去,旧键不会被清除。多次调用会导致重复 key 积累、值覆盖不可控:
立即学习“Java免费学习笔记(深入)”;
Properties props = new Properties(); props.load(is1); // key=a → value=1 props.load(is2); // key=a → value=2,但 key=b 也进来了,a 的旧值已丢失,无法追溯
- 如需合并多个配置源,应分别加载到不同
Properties实例,再用putAll()显式控制优先级 - 生产环境建议封装成单例 + 延迟加载,或配合
WatchService实现热刷新(但要注意线程安全与 reload 原子性)
真正麻烦的不是读,而是当配置项开始需要类型转换(比如把 timeout=3000 转成 int)、校验(db.url 必须含 jdbc:)、或 fallback 到环境变量时,Properties 就力不从心了——这时候该考虑 Apache Commons Configuration 或 micrometer-jvm-extras 这类增强工具,而不是硬加一堆 Integer.parseInt() 和 if (prop == null)。










