printwriter是字符输出流，专用于格式化文本写入，支持指定编码、自动换行和异常屏蔽；它不处理字节，需通过outputstreamwriter桥接字节流，核心用途是安全高效地输出人类可读文本。

PrintWriter 是字符流，不能直接用于字节流操作；它专为写入文本设计，内部自动处理字符编码与换行符，使用时需搭配合适的字符输出目标（如文件、字符串缓冲区或底层字节流）。

PrintWriter 的核心用途

PrintWriter 是 字符输出流，属于 java.io 包，主要用来方便地写入格式化文本（如字符串、数字、布尔值等），并支持自动换行（println()）和异常屏蔽（默认不抛出 IOException）。

Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载

它不是字节流，也不继承自 OutputStream；因此不能像 FileOutputStream 那样直接写入原始字节。若需用 PrintWriter 写入文件，本质是将字符经指定编码（如 UTF-8）转为字节后写入磁盘——这个转换由它包装的底层字符流（如 OutputStreamWriter）完成。

常见写入方式（推荐用法）

• 写入文件（推荐指定编码）： 避免使用默认平台编码，显式传入 Charset 或 String 编码名

  try (PrintWriter pw = new PrintWriter(Files.newBufferedWriter(
              Paths.get("output.txt"), StandardCharsets.UTF_8))) {
          pw.println("你好，世界！");
          pw.printf("数值：%d，状态：%s", 42, "OK");
      }

• 包装 OutputStream（需手动桥接）： 必须通过 OutputStreamWriter 转换，否则编译不通过

  try (PrintWriter pw = new PrintWriter(
              new OutputStreamWriter(new FileOutputStream("data.txt"), 
                                     StandardCharsets.UTF_8))) {
          pw.write("这是一行文本");
          pw.flush(); // 注意：PrintWriter 默认不自动 flush，除非构造时启用 autoFlush
      }

• 写入字符串（测试/调试常用）：

  StringWriter sw = new StringWriter();
      try (PrintWriter pw = new PrintWriter(sw)) {
          pw.println("第一行");
          pw.println("第二行");
      }
      String result = sw.toString(); // 获取生成的文本

注意事项与避坑点

• 不抛异常但可能静默失败： PrintWriter 的大多数写入方法（如 print(), println()）不会抛出 IOException，错误会内部标记。务必调用 checkError() 判断是否出错。
• 换行符依赖系统属性： println() 使用 System.lineSeparator()，Windows 是 \r\n，Linux/macOS 是 \n。如需固定换行，直接用 write("\n")。
• 缓冲与刷新： PrintWriter 默认带缓冲，内容未必立即写入目标。显式调用 flush() 或构造时启用 autoFlush=true（仅对 println、printf、format 生效）。
• 不要混用字节流操作： 若已用 FileOutputStream 打开文件，不可直接传给 PrintWriter 构造器——必须包一层 OutputStreamWriter，否则编译报错。

为什么不用字节流直接写文本？

字节流（如 FileOutputStream）只认 byte[]，写中文等非 ASCII 字符需自行编码（如 "你好".getBytes(StandardCharsets.UTF_8)），易出错且无格式化支持（如 printf）。PrintWriter 把编码、缓冲、格式化封装好了，专注“写人能读的文本”这一场景。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南