Java Properties.storeToXML 怎样保存带非拉丁字符的配置

需要把中文、日文或其他非拉丁字符写进 Java 配置时，优先使用 Properties.storeToXML，不要把 XML 配置当成普通 store(OutputStream, ...) 文件处理。无编码参数的重载默认使用 UTF-8；如果部署协议要求固定字符集，则使用 Charset 重载，并用同一套 XML 读写方法配对。

默认 UTF-8 读写链路：非拉丁字符为什么能保留

Properties 的键和值应该通过 setProperty 写入，随后把输出流交给 storeToXML。这个方法生成的是 Java Properties 约定的 XML 文档，不是任意 XML 配置格式；读取时要用 loadFromXML，不能拿 load(InputStream) 去读。

下面的例子把保存和读回放在同一段代码中，重点是两边都采用 XML API。try-with-resources 负责关闭文件流；storeToXML 返回后流仍可能保持打开，所以不要把关闭动作省略。

import java.io.InputStream;
import java.io.OutputStream;
import java.nio.file.Files;
import java.nio.file.Path;
import java.util.Properties;

Path file = Path.of("app-config.xml");
Properties props = new Properties();
// 只用字符串键值，避免序列化时出现 ClassCastException。
props.setProperty("app.name", "数据服务");
props.setProperty("app.locale", "zh-CN");

// 无编码参数的 XML 重载默认使用 UTF-8。
try (OutputStream out = Files.newOutputStream(file)) {
    props.storeToXML(out, "应用配置");
}

Properties restored = new Properties();
// XML 文件必须用 loadFromXML 读取；该方法会关闭输入流。
try (InputStream in = Files.newInputStream(file)) {
    restored.loadFromXML(in);
}
System.out.println(restored.getProperty("app.name"));

Charset 重载与 XML 格式的边界

如果配置文件要与另一个系统约定 UTF-16，可以明确传入 Charset。Java API 要求实现支持 UTF-8 和 UTF-16；其他字符集是否可用取决于实现。编码参数只解决字节如何写入，不能把 XML 文件变成传统的 .properties 文本。

import java.io.OutputStream;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;

Path file = Path.of("app-config-utf16.xml");
// 显式选择 UTF-16，读者和对端系统都能从接口调用看出约定。
try (OutputStream out = Files.newOutputStream(file)) {
    props.storeToXML(out, "跨系统配置", StandardCharsets.UTF_16);
}

保存前后的检查清单

第一，确认每个键和值都是 String，不要直接用继承自 Hashtable 的 put 塞入其他对象。第二，确认对端期待 XML；如果对端只会读取传统 properties，就应该继续使用 store，而不是只改文件后缀。第三，读回失败时优先检查 XML 文档结构、DOCTYPE 和编码声明，格式不合法会抛出 InvalidPropertiesFormatException。第四，保存和读取分别管理自己的流，不要依赖方法替你关闭输出流。

生产配置还应把临时文件写完后再替换目标文件，避免进程中断留下半个 XML；这属于文件更新策略，不是 storeToXML 的编码参数本身。

相关问题

为什么不用 store(OutputStream, comment) 保存中文？

它面向传统 properties 文本，输出流采用 ISO-8859-1，不能直接表示的字符会写成 Unicode 转义。它并非错误，只是与 XML 文件和 loadFromXML 的读写契约不同。

storeToXML 能不能传任意编码名称？

字符串重载会按名称查找字符集，找不到或不支持时会失败。跨系统场景更适合传 StandardCharsets 常量，并让读取方按 XML 声明处理。