DOM4J通过OutputFormat.setEncoding()指定输出编码并匹配对应字节流（如OutputStreamWriter）来控制XML编码，XML声明中的encoding属性由输出器自动生成；写入String时编码设置无效，读取时编码由输入源决定。
DOM4J 本身不直接“设置 XML 的编码格式”，而是通过 输出时指定字符编码 来控制生成的 XML 文件或字符串使用哪种编码（如 UTF-8、GBK）。XML 声明中的 encoding 属性（如 ）由输出器（XMLWriter 或 OutputFormat）自动写入，前提是正确配置了编码参数。
1. 使用 OutputFormat 指定编码并启用 XML 声明
这是最常用的方式。创建 OutputFormat 实例，设置编码和是否输出 XML 声明：
-
OutputFormat.setEncoding("UTF-8")：告诉输出器用 UTF-8 编码写入内容 -
OutputFormat.setSuppressDeclaration(false)（默认就是 false）：确保生成声明
示例代码：
Document document = DocumentHelper.createDocument();
document.addComment("Hello World");
OutputFormat format = OutputFormat.createPrettyPrint();
format.setEncoding("UTF-8"); // ✅ 关键：设置编码
format.setSuppressDeclaration(false); // 确保输出
XMLWriter writer = new XMLWriter(new FileWriter("output.xml"), format);
writer.write(document);
writer.close();
生成的文件头部会是：
立即学习“Java免费学习笔记（深入）”；
2. 写入到 OutputStream 时注意字节流编码匹配
如果写入的是 FileOutputStream 或网络流，必须用 OutputStreamWriter 包装，并指定相同编码，否则实际字节写入可能乱码：
本文档主要讲述的是Android的资源与国际化设置；资源是外部文件（不含代码的文件），它被代码使用并在编译时编入应用程序。Android支持不同类型的资源文件，包括XML，PNG以及JPEG文件XML文件根据描述的不同有不同格式。这份文档描述可以支持什么样的文件，语法，以及各种格式。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
OutputStream os = new FileOutputStream("output.xml");
OutputStreamWriter osw = new OutputStreamWriter(os, "UTF-8"); // ✅ 必须和 OutputFormat.setEncoding 一致
XMLWriter writer = new XMLWriter(osw, format);
writer.write(document);
writer.close();
⚠️ 错误做法：只设 OutputFormat.setEncoding("UTF-8")，但用 FileWriter("xxx.xml")（它用系统默认编码），会导致声明写的是 UTF-8，实际内容却是 GBK 字节 —— XML 解析时会报错。
3. 写入字符串时无需手动设编码（String 无编码概念）
若用 XMLWriter 写入 StringWriter 获取 XML 字符串，OutputFormat.setEncoding() 不起作用（因为 String 是 Unicode 内存表示）：
StringWriter sw = new StringWriter();
XMLWriter writer = new XMLWriter(sw, format); // format.setEncoding("UTF-8") 这里被忽略
writer.write(document);
String xmlStr = sw.toString(); // ✅ 得到的是正常 Unicode 字符串
// 后续若要保存为文件，再按需用 UTF-8 字节写出
此时 XML 声明里的 encoding="UTF-8" 仅作语义提示，真正编码由你后续保存时决定。
4. 读取已有 XML 时编码由输入源决定，与 DOM4J 设置无关
DOM4J 解析 XML 时，编码由输入源（如文件 BOM、XML 声明、HTTP Content-Type 或 SAX 解析器默认）决定，OutputFormat 对读取过程完全无效。确保原始文件编码和声明一致即可，例如文件是 UTF-8 且开头有 ，DOM4J 就能正确识别。
基本上就这些。核心就一条：输出时靠 OutputFormat.setEncoding() + 匹配的字节流/Writer，其他地方设了也没用。
