Properties.store()写入空文件或乱码，主因是默认ISO-8859-1编码不支持中文，导致值被转义或解码失败；需用OutputStreamWriter指定UTF-8并配合try-with-resources确保正确写入。
Properties.store() 为什么会写入空文件或乱码
直接调用 Properties.store() 却发现生成的文件内容为空，或者打开后全是问号、方块，大概率是编码问题。Java 的 Properties 默认使用 ISO-8859-1 编码读写，它不支持中文等 Unicode 字符——哪怕你用 put("name", "张三") 存进去，store() 也会把“张三”转成 name=u5F20u4E09 形式；而如果手动改过文件、或用非兼容编辑器保存过，就容易触发解码失败，表现为乱码或空内容。
- 必须确保写入前所有键值对的 value 都是合法字符串（null 值会抛
NullPointerException） - 注释行（header comment）也受相同编码限制，含中文时需用
\uXXXX转义，或改用storeToXML() - 若要原生支持 UTF-8 文本内容，不能依赖
store(OutputStream, String)，得自己封装 OutputStreamWriter
如何用 UTF-8 正确写出可读的 .properties 文件
标准 store() 不接受 charset 参数，所以得绕过它：用 OutputStreamWriter 包一层，指定 UTF-8，并把 Properties 的 key/value 按 .properties 格式手动写入——但别手写，复用 Properties.saveConvert()（虽是 package-private，但可用反射或更稳妥的方式：用 String.format() + Properties.escape() 逻辑）。实际开发中更推荐以下做法：
- 用
Files.newBufferedWriter(Paths.get("config.properties"), StandardCharsets.UTF_8)创建 writer - 调用
properties.store(writer, "Generated on " + new Date())——注意：JDK 7+ 的store(WritableByteChannel, String)不行，必须是Writer重载版本 - 确保 JVM 启动参数没强制设置
file.encoding=ISO-8859-1，否则StandardCharsets.UTF_8可能被忽略
示例关键代码：
try (Writer writer = Files.newBufferedWriter(Paths.get("app.conf"), StandardCharsets.UTF_8)) {
props.store(writer, "App config - saved at " + new Date());
}
store() 抛 IOException 的常见原因和排查点
不是权限不足就是路径不对，但具体错在哪，得看异常堆栈里的 IOException 真实 message：
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
-
No such file or directory：父目录不存在，store()不会自动创建路径，得先Files.createDirectories() -
Access denied：Windows 下文件被记事本/IDE 锁住，或 Linux 下目标路径无写权限（注意：不是当前进程工作目录权限，而是文件最终落盘路径的父目录权限） -
Stream closed：传入的OutputStream或Writer已提前 close，检查是否在store()前调了close() - 若用
new FileOutputStream(file)构造流，记得传true参数才能追加写；默认是覆盖，容易误删旧配置
为什么 store() 后文件时间戳没变或内容没刷新
磁盘缓存或 flush 失败会导致写入延迟可见。虽然 store() 内部会调 flush()，但某些包装流（比如自定义的缓冲流）可能没正确代理。最保险的做法是：
- 不用
FileOutputStream直接构造，优先走Files.newOutputStream()+BufferedOutputStream - 写完显式调
writer.flush()（即使 try-with-resources 会 close，但 close 前 flush 不一定 100% 成功） - Linux/macOS 下可加
Files.getAttribute(path, "unix:st_mtime_ns")验证修改时间是否更新；Windows 则注意 FAT32 分区时间精度只有 2 秒
真正容易被忽略的是：如果 properties 对象里存了对象引用（比如 props.put("db", dataSource)），store() 会调 toString()，结果写入一串类似 com.zaxxer.hikari.HikariDataSource@3a71f5e6 的字符串——这不是 bug，是设计如此，但常被当成“写入失败”。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
