JavaProperties.store保存配置详解

Java中使用Properties.store()保存配置文件看似简单，实则暗藏编码乱码、资源泄漏、格式失真等多重陷阱——默认ISO-8859-1编码会让中文变成\uXXXX转义或直接乱码，未用try-with-resources可能导致写入不完整，而store()固有的格式规则（如自动转义、强制时间戳注释、忽略空行）更让配置维护变得不可控；真正可靠的实践是：先确保键值正确加载，再通过OutputStreamWriter显式指定UTF-8编码，并始终依托try-with-resources安全关闭流——掌握这些底层逻辑，才能写出稳定、可读、无坑的配置持久化代码。

Java中用Properties.store()写入配置文件，核心是确保键值对正确加载、输出流正确打开、字符编码统一，且注释和格式符合预期。默认使用ISO-8859-1编码，中文容易乱码，这是最常踩的坑。

确保Properties对象已正确加载或设置键值

store前必须有实际数据，否则生成空文件或仅含注释头。可手动put，也可先load已有配置再修改：

• 直接添加：props.put("db.url", "jdbc:mysql://localhost:3306/test")
• 从文件加载后更新：props.load(new FileInputStream("config.properties")); props.setProperty("version", "2.1");
• 注意：setProperty()会自动调用toString()，适合String值；若存Object，需自行转字符串

用OutputStream + 指定编码避免中文乱码

默认store(OutputStream, String)按ISO-8859-1写入，中文会被转义成\uXXXX。解决方法是用storeToXML()或改用Writer并指定UTF-8：

• 推荐方式（UTF-8明文）：props.store(new OutputStreamWriter(new FileOutputStream("config.properties"), StandardCharsets.UTF_8), "Updated on " + new Date())
• 不推荐：props.store(new FileOutputStream("config.properties"), comment) —— 中文注释和值都会乱码
• 如必须用store()且含中文，注释里别写中文，值用Unicode转义（不实用，仅作了解）

注意store的输出格式与换行行为

store()生成的是传统properties格式：每行一个key=value，等号前后无空格，反斜杠用于转义换行/特殊字符。它不会保留原始文件的空行或注释位置：

• 值含换行符时，会自动转为\n并加反斜杠续行（如msg=hello\ntest）
• 键或值含#、!、=、:等，会被自动转义（如key\=value）
• 生成的文件头部带时间戳注释，格式为#Mon Jun 10 10:23:45 CST 2024，不可关闭

异常处理与资源关闭不能省略

文件I/O可能抛出IOException，输出流必须显式关闭（或用try-with-resources）：

• 安全写法：务必用try-with-resources
• 示例：try (Writer writer = new OutputStreamWriter(new FileOutputStream("config.properties"), UTF_8)) { props.store(writer, "Saved by app"); }
• 忽略关闭可能导致文件写入不完整，尤其在频繁保存场景下

基本上就这些。关键不是记方法签名，而是理解store背后默认编码、格式规则和资源管理逻辑。配错编码，写进去的中文看着像乱码；忘了关流，下次读可能读到旧内容。

以上就是《JavaProperties.store保存配置详解》的详细内容，更多关于的资料请关注golang学习网公众号！