在java字节流与字符流中,使用printwriter的printf方法时,核心区别在于是否指定了字符集。对于字节流(如fileoutputstream),必须通过构造函数显式传入charset或string编码名称,否则默认使用平台默认编码,可能导致跨平台乱码;对于字符流(如filewriter),由于流本身已处理字符转换,printwriter内部会直接使用流的字符集,无需额外指定。

如何为字节流创建支持 printf 的 PrintWriter
为字节流创建PrintWriter并启用自动刷新和指定编码,需调用双参数构造函数new PrintWriter(OutputStream out, boolean autoFlush, String encoding)。这样创建的实例可以直接使用printf格式化输出,且确保写入文件时使用UTF-8等指定编码,避免中文乱码。

import java.io.FileOutputStream;
import java.io.PrintWriter;
import java.nio.charset.StandardCharsets;
public class ByteStreamExample {
public static void main(String[] args) throws Exception {
// 使用 FileOutputStream (字节流)
// 关键:指定编码为 UTF-8,启用自动刷新
try (PrintWriter pw = new PrintWriter(
new FileOutputStream("byte_output.txt"),
true,
StandardCharsets.UTF_8.name())) {
// 使用 printf 进行格式化输出
pw.printf("姓名: %s, 年龄: %d%n", "张三", 25);
pw.printf("分数: %.2f%n", 95.5);
}
// 文件 byte_output.txt 将包含正确编码的中文字符
}
}
运行上述代码后,生成的byte_output.txt文件内容如下:
姓名: 张三, 年龄: 25
分数: 95.50
注意:如果省略第三个参数StandardCharsets.UTF_8.name(),则使用系统默认编码,在Windows上可能是GBK,在Linux/Mac上通常是UTF-8,这会导致在不同操作系统间移动文件时出现乱码风险。
立即学习“Java免费学习笔记(深入)”;
如何为字符流创建支持 printf 的 PrintWriter
为字符流(如FileWriter)创建PrintWriter时,只需关注是否启用自动刷新。因为FileWriter本身已经根据平台默认编码将字符转换为字节,PrintWriter只是在其上层提供便捷的格式化打印功能,所以不需要也不应该再指定编码。

import java.io.FileWriter;
import java.io.PrintWriter;
public class CharStreamExample {
public static void main(String[] args) throws Exception {
// 使用 FileWriter (字符流)
// 关键:只需指定 autoFlush,编码由 FileWriter 决定
try (PrintWriter pw = new PrintWriter(
new FileWriter("char_output.txt"),
true)) {
// 使用 printf 进行格式化输出
pw.printf("姓名: %s, 年龄: %d%n", "李四", 30);
pw.printf("成绩: %.1f%n", 88.8);
}
// 文件 char_output.txt 中的中文取决于 FileWriter 的平台默认编码
}
}
运行上述代码后,生成的char_output.txt文件内容如下:
姓名: 李四, 年龄: 30
成绩: 88.8
与字节流不同,这里没有指定编码参数。FileWriter在构造时会使用System.getProperty("file.encoding")指定的编码。如果在Windows中文版环境下,这通常是GBK;如果在Linux服务器上是UTF-8。因此,跨平台使用时,字符流方式不如字节流方式可控。
当 printf 格式字符串中包含特殊字符时如何处理
当printf的格式字符串中包含百分号%以外的特殊字符(如换行符%n、制表符\t)或需要转义的字面量百分号%%时,PrintWriter的行为与System.out.printf一致,遵循java.util.Formatter的规则。例如,要输出一个字面量的百分号,必须使用%%;要输出换行,推荐使用%n而非\n,以确保跨平台兼容性。
import java.io.PrintWriter;
import java.io.StringWriter;
public class PrintfSpecialChars {
public static void main(String[] args) {
StringWriter sw = new StringWriter();
try (PrintWriter pw = new PrintWriter(sw)) {
// 示例1: 输出百分比
pw.printf("进度: 50%%%n"); // 输出: 进度: 50%
// 示例2: 使用 %n 换行
pw.printf("第一行%n第二行%n");
// 示例3: 混合使用
pw.printf("用户: %s, 折扣: %.2f%%, 状态: OK%n", "Alice", 0.85);
}
System.out.println(sw.toString());
}
}
该程序的输出结果为:
进度: 50%
第一行
第二行
用户: Alice, 折扣: 0.85%, 状态: OK
关键点在于:%%会被解释为一个字面量的%字符;%n是平台无关的换行符,而\n是Unix/Linux风格的换行符,在Windows上可能显示为一行(如果终端不识别)。在PrintWriter中使用printf时,始终推荐%n以保证可移植性。


















