掌握 Java PrintStream 类：print、println 与 printf 详解

掌握 Java PrintStream 类

PrintStream 位于 java.io，继承 OutputStream，专为输出人类可读文本而非原始字节设计。

PrintStream 工作原理

与其他流不同，PrintStream 在写入前将基本类型（int、char 等）转为格式化文本。且不抛 IOException，错误通过 checkError() 报告。

自动刷新是关键特性：以下情况自动刷新：

• 打印换行符（\n）
• 调用 println()
• 写入字节数组

创建 PrintStream

导入类：

import java.io.PrintStream;

1. 从现有 OutputStream

// 例：包装 FileOutputStream
FileOutputStream fos = new FileOutputStream("log.txt");
PrintStream ps = new PrintStream(fos, true); // true = autoFlush

向 log.txt 写格式化文本，可选自动刷新。

2. 直接从文件名

PrintStream ps = new PrintStream("log.txt", true);

构造器接受布尔值控制自动刷新。默认使用平台字符编码。

3. 指定字符集

PrintStream ps = new PrintStream("log.txt", true, StandardCharsets.UTF_8);

用 Charset 选择 UTF-8、UTF-16 等编码。详见 Java Charset API。

PrintStream 核心方法

print() 和 println()

• print(Object obj) – 输出对象字符串表示
• println(Object obj) – 追加平台相关行终止符

示例：使用 System.out

public class Main {
    public static void main(String[] args) {
        System.out.print("Hello World.");
    }
}

System.out 是预配置 PrintStream，直接可用 print()。

示例：写入文件

import java.io.PrintStream;
public class Main {
    public static void main(String[] args) {
        try {
            PrintStream ps = new PrintStream("output.txt");
            ps.print("This is a text inside the file.");
            ps.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

生成的 output.txt 内容：

This is a text inside the file.

printf()

使用格式说明符打印格式化文本：

System.out.printf("I am %d years old", 25);

%d 替换为整数 25。

示例：文件中使用 printf()

import java.io.PrintStream;
public class Main {
    public static void main(String[] args) {
        try {
            PrintStream ps = new PrintStream("output.txt");
            int age = 25;
            ps.printf("I am %d years old.", age);
            ps.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

执行后 output.txt 内容：

I am 25 years old.

PrintStream 其他方法

详细参考官方 Java PrintStream 文档。