在java中，使用 printwriter 的 println() 方法向字节流或字符流写入数据时，核心区别在于是否自动进行字符编码转换以及换行符的处理方式。若直接包装 outputstream（如 fileoutputstream），必须指定 charset 否则默认使用平台默认编码；若包装 writer（如 filewriter），则继承该 writer 的编码设置。调用 println() 会自动追加当前平台的换行符（windows为 \r\n，linux/unix为 \n），且建议开启自动刷新功能以便数据立即输出到目标流。
如何正确初始化 PrintWriter 以支持 UTF-8 编码？
要确保 PrintWriter 正确处理中文等非ASCII字符，应优先使用接受 OutputStream 和 Charset 参数的构造函数，或者使用 OutputStreamWriter 作为中间层。直接传入 FileOutputStream 而不指定编码会导致在不同操作系统上产生乱码。推荐使用 StandardCharsets.UTF_8 显式指定编码，这样无论运行环境如何，输出的字节序列都是标准的UTF-8格式。
import java.io.*;
import java.nio.charset.StandardCharsets;
public class PrintWriterDemo {
public static void main(String[] args) throws IOException {
// 方式一：直接包装 OutputStream，指定 UTF-8 编码
try (PrintWriter pw = new PrintWriter(
new FileOutputStream("output_bytes.txt"),
StandardCharsets.UTF_8)) {
pw.println("Hello World");
pw.println("中文测试");
}
// 方式二：通过 Writer 包装，继承 FileWriter 的编码
try (PrintWriter pw = new PrintWriter(
new BufferedWriter(new FileWriter("output_chars.txt", StandardCharsets.UTF_8)))) {
pw.println("Hello World");
pw.println("中文测试");
}
}
}
上述代码展示了两种初始化方式。方式一中，PrintWriter(OutputStream out, Charset charset) 内部会创建一个 OutputStreamWriter 并指定编码。方式二中，FileWriter 本身需要指定编码（注意 FileWriter 的构造器不直接接受 Charset，需通过 OutputStreamWriter 或直接使用 BufferedWriter 配合 OutputStreamWriter，这里为了演示清晰，实际生产环境中更推荐直接用 new PrintWriter(new OutputStreamWriter(new FileOutputStream(...), StandardCharsets.UTF_8)) 或 Java 11+ 的 Files.newBufferedWriter）。但最简洁且安全的做法是直接使用 new PrintWriter(OutputStream, boolean autoFlush, Charset charset) 或类似变体。在实际操作中，确保编码一致是关键。
立即学习“Java免费学习笔记（深入）”；
println() 方法的自动刷新与缓冲行为是怎样的？
PrintWriter 默认情况下不会自动刷新缓冲区，这意味着数据可能暂时存储在内存中，直到缓冲区满、关闭流或显式调用 flush() 才会写入到底层流。如果在创建 PrintWriter 时将 autoFlush 参数设置为 true，则在每次调用 println()、printf() 或 format() 后，缓冲区会自动刷新。这对于实时日志输出或交互式应用非常重要，但对于大量数据的批量写入，频繁刷新会降低性能。
import java.io.*;
import java.nio.charset.StandardCharsets;
public class AutoFlushDemo {
public static void main(String[] args) throws IOException {
String fileName = "autoflush_test.txt";
// 自动刷新为 false（默认）
try (PrintWriter pwNoAuto = new PrintWriter(new FileOutputStream(fileName), false)) {
pwNoAuto.println("Line 1");
// 此时文件可能为空或只有部分数据，因为未刷新
}
// 自动刷新为 true
try (PrintWriter pwAuto = new PrintWriter(new FileOutputStream(fileName, true), true)) { // true 表示追加模式
pwAuto.println("Line 2");
// 此时 Line 2 已立即写入文件
}
// 验证内容
System.out.println(new String(Files.readAllBytes(Paths.get(fileName)), StandardCharsets.UTF_8));
}
}
在上面的示例中，第一个 PrintWriter 没有启用自动刷新，因此在 try-with-resources 块结束时才刷新，如果程序中途崩溃，数据可能丢失。第二个 PrintWriter 启用了自动刷新，每次 println 都会立即写入。注意 FileOutputStream 的第二个参数 true 表示追加模式，避免覆盖之前的内容。实际使用时，根据对实时性和性能的权衡选择是否启用自动刷新。
当 println() 遇到 null 值时会发生什么？
当 PrintWriter 的 println(Object obj) 方法接收到 null 值时，它不会抛出异常，而是将字符串 "null" 写入输出流。这是 PrintWriter 的设计特性，旨在简化代码，避免开发者在每个打印语句前都进行空指针检查。例如，pw.println(null) 等价于 pw.println("null")。这一行为在处理可选字段或动态生成的对象列表时非常有用，可以保持代码简洁。
以下代码验证了这一行为：
import java.io.*;
import java.nio.charset.StandardCharsets;
public class NullHandlingDemo {
public static void main(String[] args) throws IOException {
try (PrintWriter pw = new PrintWriter(new ByteArrayOutputStream(), StandardCharsets.UTF_8)) {
pw.println(null);
pw.println((String) null);
pw.println(Integer.valueOf(null)); // 这会抛出 NullPointerException，因为 Integer.valueOf(null) 先执行
} catch (Exception e) {
e.printStackTrace();
}
}
}
注意，println(Object) 接收的是对象引用。如果传入的是基本类型的包装类（如 Integer），且该包装类实例为 null，则 println 会将其视为 null 并输出 "null"。但如果尝试对 null 进行自动装箱或解箱操作（如 println((int) null) 是不合法的，但 println(Integer.valueOf(null)) 会在调用 println 之前抛出 NullPointerException，因为 Integer.valueOf(null) 返回 null，然后 println(null) 被调用，所以实际上不会抛异常，而是输出 "null"。更正：Integer.valueOf(null) 确实返回 null，所以 println(null) 被调用，输出 "null"。但如果使用 println(int i) 并传入一个可能为 null 的 Integer 变量，编译器会报错，因为无法将 Integer 隐式转换为 int，除非进行强制转换，而强制转换 null 会抛出 NullPointerException。因此，println(Object) 是唯一能安全处理 null 引用重载方法。
