为何指定Cp1252编码时BufferedWriter却输出UTF-8文本文件？

核心排查与解决方案 #

1. 先验证实际文件编码（别只依赖Notepad++）

Notepad++的编码检测是启发式逻辑，偶尔会出现误判。拿带重音的字符（比如é）做测试：

• Cp1252编码中，é对应单字节0xE9
• UTF-8编码中，é对应双字节0xC3 0xA9

用十六进制编辑器打开输出文件，查看该字符的字节：

• 如果是单字节：说明文件实际是Cp1252，只是Notepad++检测出错，无需修改代码
• 如果是双字节：说明写入时编码未生效，继续往下排查

2. 替换写入代码，使用Charset对象而非字符串

Java中直接传字符集字符串可能存在隐性兼容问题，改用Charset对象显式指定编码，同时用try-with-resources语法确保资源正确关闭：

// 替换原写入代码
Charset targetCharset = Charset.forName(CHARACTER_SET);
try (BufferedWriter writer = Files.newBufferedWriter(file.toPath(), targetCharset)) {
    writer.write(this.toString());
    System.out.println("Writing " + name + " (" + method + ") using " + targetCharset.name() + " encoding");
} catch (IOException e) {
    e.printStackTrace();
}

3. 排查代码中的隐性干扰

• 确认写入前CHARACTER_SET未被篡改：在写入代码前再打印一次CHARACTER_SET的值，或者加断言验证：

  assert CHARACTER_SET.equals("windows-1252") : "Unexpected charset: " + CHARACTER_SET;
  

• 检查是否有后续代码修改文件：确保没有其他线程或代码段在写入后再次修改该文件
• 验证toString()方法的正确性：确认this.toString()返回的字符串未被错误转换，可通过打印字符的Unicode码点验证加载后的内容是否正确

4. 规范字符集名称

Java中推荐使用标准字符集名称：

• UTF-8用"UTF-8"而非"UTF8"（虽然Java兼容后者，但标准名称更可靠）
• Cp1252用"windows-1252"或"Cp1252"，两者都被Java官方支持

内容的提问来源于stack exchange，提问作者theolaa