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：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
-
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，是设计如此，但常被当成“写入失败”。
