1. 引言在 Java 的 I/O 体系中Writer是面向字符流输出的核心抽象类。与面向字节的OutputStream不同Writer专门用于处理文本数据能够自动处理字符编码转换是读写文本文件、网络通信和字符串处理中不可或缺的工具。本文将系统讲解 JavaWriter的继承体系、核心方法、常用实现类以及实战中的最佳实践帮助读者全面掌握字符输出流的使用。2. Writer 类概述2.1 什么是 WriterWriter是java.io包中所有字符输出流的抽象父类。它定义了将字符序列写入目标设备文件、内存、网络等的基本契约。与字节流相比字符流最大的优势在于它直接操作 Unicode 字符屏蔽了底层编码转换的复杂性。2.2 继承体系Writer抽象类OutputStreamWriterCharArrayWriterStringWriterBufferedWriterPrintWriterFilterWriterFileWriter2.3 核心方法Writer类提供了以下核心方法方法说明write(int c)写入单个字符write(char[] cbuf)写入字符数组write(char[] cbuf, int off, int len)写入字符数组的指定部分write(String str)写入字符串write(String str, int off, int len)写入字符串的指定部分append(char c)追加单个字符返回thisappend(CharSequence csq)追加字符序列append(CharSequence csq, int start, int end)追加字符序列的指定部分flush()刷新缓冲区将缓冲数据强制写入目标close()关闭流并释放资源3. 常用实现类详解3.1 FileWriterFileWriter用于向文件写入字符数据是最常用的文件写入方式。importjava.io.FileWriter;importjava.io.IOException;publicclassFileWriterExample{publicstaticvoidmain(String[]args){// 第二个参数 true 表示追加模式false 表示覆盖模式try(FileWriterwriternewFileWriter(output.txt,true)){writer.write(Hello, Java Writer!\n);writer.write(这是第二行内容。\n);writer.flush();System.out.println(文件写入成功);}catch(IOExceptione){e.printStackTrace();}}}3.2 BufferedWriterBufferedWriter为 Writer 添加缓冲功能减少实际 I/O 操作次数显著提升写入性能。importjava.io.BufferedWriter;importjava.io.FileWriter;importjava.io.IOException;publicclassBufferedWriterExample{publicstaticvoidmain(String[]args){try(BufferedWriterwriternewBufferedWriter(newFileWriter(buffered.txt))){writer.write(使用缓冲流写入);writer.newLine();// 写入系统相关的换行符writer.write(第二行内容);writer.newLine();// 注意close() 时会自动调用 flush()}catch(IOExceptione){e.printStackTrace();}}}3.3 OutputStreamWriterOutputStreamWriter是字符流与字节流之间的桥梁可以将字符流转换为字节流并指定字符编码。importjava.io.FileOutputStream;importjava.io.IOException;importjava.io.OutputStreamWriter;importjava.nio.charset.StandardCharsets;publicclassOutputStreamWriterExample{publicstaticvoidmain(String[]args){try(OutputStreamWriterwriternewOutputStreamWriter(newFileOutputStream(encoded.txt),StandardCharsets.UTF_8)){writer.write(使用 UTF-8 编码写入中文内容);}catch(IOExceptione){e.printStackTrace();}}}3.4 StringWriterStringWriter将字符输出收集到内存中的字符串缓冲区常用于测试或需要临时拼接文本的场景。importjava.io.IOException;importjava.io.StringWriter;publicclassStringWriterExample{publicstaticvoidmain(String[]args){try(StringWriterwriternewStringWriter()){writer.write(第一部分);writer.append(第二部分);writer.append();writer.append(第三部分);Stringresultwriter.toString();System.out.println(拼接结果: result);}catch(IOExceptione){e.printStackTrace();}}}3.5 PrintWriterPrintWriter提供了格式化输出能力支持print()、println()和printf()等方法使用非常方便。importjava.io.FileWriter;importjava.io.IOException;importjava.io.PrintWriter;publicclassPrintWriterExample{publicstaticvoidmain(String[]args){try(PrintWriterwriternewPrintWriter(newFileWriter(print.txt))){writer.println(姓名: 张三);writer.println(年龄: 25);writer.printf(成绩: %.2f 分%n,92.5);writer.printf(学号: %06d%n,12345);}catch(IOExceptione){e.printStackTrace();}}}3.6 CharArrayWriterCharArrayWriter将数据写入内存中的字符数组适合需要多次写入后统一处理的场景。importjava.io.CharArrayWriter;importjava.io.IOException;publicclassCharArrayWriterExample{publicstaticvoidmain(String[]args){try(CharArrayWriterwriternewCharArrayWriter()){writer.write(Hello);writer.write(, World!);char[]datawriter.toCharArray();System.out.println(字符数组长度: data.length);System.out.println(内容: writer.toString());}catch(IOExceptione){e.printStackTrace();}}}4. 实战案例4.1 复制文本文件importjava.io.BufferedReader;importjava.io.BufferedWriter;importjava.io.FileReader;importjava.io.FileWriter;importjava.io.IOException;publicclassFileCopyExample{publicstaticvoidcopyFile(Stringsource,Stringtarget){try(BufferedReaderreadernewBufferedReader(newFileReader(source));BufferedWriterwriternewBufferedWriter(newFileWriter(target))){Stringline;while((linereader.readLine())!null){writer.write(line);writer.newLine();}System.out.println(文件复制完成);}catch(IOExceptione){e.printStackTrace();}}publicstaticvoidmain(String[]args){copyFile(source.txt,target.txt);}}4.2 生成 CSV 文件importjava.io.BufferedWriter;importjava.io.FileWriter;importjava.io.IOException;importjava.io.PrintWriter;publicclassCsvGenerator{publicstaticvoidmain(String[]args){String[][]data{{姓名,部门,薪资},{张三,技术部,15000},{李四,市场部,12000},{王五,人事部,10000}};try(PrintWriterwriternewPrintWriter(newBufferedWriter(newFileWriter(employees.csv)))){for(String[]row:data){writer.println(String.join(,,row));}System.out.println(CSV 文件生成成功);}catch(IOExceptione){e.printStackTrace();}}}4.3 日志写入工具类importjava.io.BufferedWriter;importjava.io.FileWriter;importjava.io.IOException;importjava.io.PrintWriter;importjava.time.LocalDateTime;importjava.time.format.DateTimeFormatter;publicclassLogger{privatestaticfinalDateTimeFormatterFORMATTERDateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss);privatefinalStringlogFile;publicLogger(StringlogFile){this.logFilelogFile;}publicvoidlog(Stringlevel,Stringmessage){StringtimestampLocalDateTime.now().format(FORMATTER);StringlogLineString.format([%s] [%s] %s,timestamp,level,message);try(PrintWriterwriternewPrintWriter(newBufferedWriter(newFileWriter(logFile,true)))){writer.println(logLine);}catch(IOExceptione){e.printStackTrace();}}publicstaticvoidmain(String[]args){LoggerloggernewLogger(app.log);logger.log(INFO,应用启动);logger.log(WARN,内存使用率偏高);logger.log(ERROR,数据库连接失败);}}5. 性能优化与最佳实践5.1 使用缓冲流直接写入文件时每次write()调用都会触发系统调用性能较差。使用BufferedWriter可以显著减少 I/O 次数// 不推荐频繁系统调用try(FileWriterwriternewFileWriter(data.txt)){for(inti0;i10000;i){writer.write(line i\n);}}// 推荐使用缓冲try(BufferedWriterwriternewBufferedWriter(newFileWriter(data.txt))){for(inti0;i10000;i){writer.write(line i\n);}}5.2 合理设置缓冲区大小BufferedWriter默认缓冲区大小为 8KB可以根据实际场景调整// 设置 32KB 缓冲区BufferedWriterwriternewBufferedWriter(newFileWriter(large.txt),32*1024);5.3 使用 try-with-resourcesJava 7 引入的 try-with-resources 语法可以自动关闭资源避免资源泄漏// 推荐自动关闭try(BufferedWriterwriternewBufferedWriter(newFileWriter(data.txt))){writer.write(content);}catch(IOExceptione){e.printStackTrace();}5.4 指定字符编码在 Java 11 之前FileWriter默认使用平台编码跨平台时可能出现乱码。建议显式指定编码// Java 11 推荐try(FileWriterwriternewFileWriter(data.txt,StandardCharsets.UTF_8)){writer.write(中文内容);}// 通用方案try(OutputStreamWriterwriternewOutputStreamWriter(newFileOutputStream(data.txt),StandardCharsets.UTF_8)){writer.write(中文内容);}6. 常见问题与注意事项6.1 忘记关闭流忘记调用close()会导致资源泄漏和缓冲区数据丢失。务必使用 try-with-resources 或 finally 块确保关闭。6.2 编码不一致导致乱码写入和读取时使用的编码必须一致否则会出现乱码。建议统一使用 UTF-8。6.3 flush 与 close 的区别flush()将缓冲区数据强制写入目标流仍然可用close()先 flush 再关闭流释放资源6.4 追加模式FileWriter构造器的第二个参数控制是否追加// 覆盖模式默认newFileWriter(data.txt);// 追加模式newFileWriter(data.txt,true);7. 总结JavaWriter体系为字符输出提供了强大而灵活的支持。核心要点总结如下Writer是字符输出流的抽象基类直接操作 Unicode 字符常用实现类包括FileWriter、BufferedWriter、OutputStreamWriter、StringWriter、PrintWriter等使用BufferedWriter包装可以显著提升写入性能优先使用 try-with-resources 确保资源正确关闭显式指定字符编码推荐 UTF-8避免乱码问题根据场景选择合适的实现类文件写入用FileWriter格式化输出用PrintWriter内存操作用StringWriter或CharArrayWriter掌握这些知识后你就能在 Java 项目中游刃有余地处理各种文本输出需求了。 
长河君 · 2026/9/6 8:20:27 · 阅读 1.2k Java Writer 详解：从基础用法到实战技巧
1. 引言在 Java 的 I/O 体系中Writer是面向字符流输出的核心抽象类。与面向字节的OutputStream不同Writer专门用于处理文本数据能够自动处理字符编码转换是读写文本文件、网络通信和字符串处理中不可或缺的工具。本文将系统讲解 JavaWriter的继承体系、核心方法、常用实现类以及实战中的最佳实践帮助读者全面掌握字符输出流的使用。2. Writer 类概述2.1 什么是 WriterWriter是java.io包中所有字符输出流的抽象父类。它定义了将字符序列写入目标设备文件、内存、网络等的基本契约。与字节流相比字符流最大的优势在于它直接操作 Unicode 字符屏蔽了底层编码转换的复杂性。2.2 继承体系Writer抽象类OutputStreamWriterCharArrayWriterStringWriterBufferedWriterPrintWriterFilterWriterFileWriter2.3 核心方法Writer类提供了以下核心方法方法说明write(int c)写入单个字符write(char[] cbuf)写入字符数组write(char[] cbuf, int off, int len)写入字符数组的指定部分write(String str)写入字符串write(String str, int off, int len)写入字符串的指定部分append(char c)追加单个字符返回thisappend(CharSequence csq)追加字符序列append(CharSequence csq, int start, int end)追加字符序列的指定部分flush()刷新缓冲区将缓冲数据强制写入目标close()关闭流并释放资源3. 常用实现类详解3.1 FileWriterFileWriter用于向文件写入字符数据是最常用的文件写入方式。importjava.io.FileWriter;importjava.io.IOException;publicclassFileWriterExample{publicstaticvoidmain(String[]args){// 第二个参数 true 表示追加模式false 表示覆盖模式try(FileWriterwriternewFileWriter(output.txt,true)){writer.write(Hello, Java Writer!\n);writer.write(这是第二行内容。\n);writer.flush();System.out.println(文件写入成功);}catch(IOExceptione){e.printStackTrace();}}}3.2 BufferedWriterBufferedWriter为 Writer 添加缓冲功能减少实际 I/O 操作次数显著提升写入性能。importjava.io.BufferedWriter;importjava.io.FileWriter;importjava.io.IOException;publicclassBufferedWriterExample{publicstaticvoidmain(String[]args){try(BufferedWriterwriternewBufferedWriter(newFileWriter(buffered.txt))){writer.write(使用缓冲流写入);writer.newLine();// 写入系统相关的换行符writer.write(第二行内容);writer.newLine();// 注意close() 时会自动调用 flush()}catch(IOExceptione){e.printStackTrace();}}}3.3 OutputStreamWriterOutputStreamWriter是字符流与字节流之间的桥梁可以将字符流转换为字节流并指定字符编码。importjava.io.FileOutputStream;importjava.io.IOException;importjava.io.OutputStreamWriter;importjava.nio.charset.StandardCharsets;publicclassOutputStreamWriterExample{publicstaticvoidmain(String[]args){try(OutputStreamWriterwriternewOutputStreamWriter(newFileOutputStream(encoded.txt),StandardCharsets.UTF_8)){writer.write(使用 UTF-8 编码写入中文内容);}catch(IOExceptione){e.printStackTrace();}}}3.4 StringWriterStringWriter将字符输出收集到内存中的字符串缓冲区常用于测试或需要临时拼接文本的场景。importjava.io.IOException;importjava.io.StringWriter;publicclassStringWriterExample{publicstaticvoidmain(String[]args){try(StringWriterwriternewStringWriter()){writer.write(第一部分);writer.append(第二部分);writer.append();writer.append(第三部分);Stringresultwriter.toString();System.out.println(拼接结果: result);}catch(IOExceptione){e.printStackTrace();}}}3.5 PrintWriterPrintWriter提供了格式化输出能力支持print()、println()和printf()等方法使用非常方便。importjava.io.FileWriter;importjava.io.IOException;importjava.io.PrintWriter;publicclassPrintWriterExample{publicstaticvoidmain(String[]args){try(PrintWriterwriternewPrintWriter(newFileWriter(print.txt))){writer.println(姓名: 张三);writer.println(年龄: 25);writer.printf(成绩: %.2f 分%n,92.5);writer.printf(学号: %06d%n,12345);}catch(IOExceptione){e.printStackTrace();}}}3.6 CharArrayWriterCharArrayWriter将数据写入内存中的字符数组适合需要多次写入后统一处理的场景。importjava.io.CharArrayWriter;importjava.io.IOException;publicclassCharArrayWriterExample{publicstaticvoidmain(String[]args){try(CharArrayWriterwriternewCharArrayWriter()){writer.write(Hello);writer.write(, World!);char[]datawriter.toCharArray();System.out.println(字符数组长度: data.length);System.out.println(内容: writer.toString());}catch(IOExceptione){e.printStackTrace();}}}4. 实战案例4.1 复制文本文件importjava.io.BufferedReader;importjava.io.BufferedWriter;importjava.io.FileReader;importjava.io.FileWriter;importjava.io.IOException;publicclassFileCopyExample{publicstaticvoidcopyFile(Stringsource,Stringtarget){try(BufferedReaderreadernewBufferedReader(newFileReader(source));BufferedWriterwriternewBufferedWriter(newFileWriter(target))){Stringline;while((linereader.readLine())!null){writer.write(line);writer.newLine();}System.out.println(文件复制完成);}catch(IOExceptione){e.printStackTrace();}}publicstaticvoidmain(String[]args){copyFile(source.txt,target.txt);}}4.2 生成 CSV 文件importjava.io.BufferedWriter;importjava.io.FileWriter;importjava.io.IOException;importjava.io.PrintWriter;publicclassCsvGenerator{publicstaticvoidmain(String[]args){String[][]data{{姓名,部门,薪资},{张三,技术部,15000},{李四,市场部,12000},{王五,人事部,10000}};try(PrintWriterwriternewPrintWriter(newBufferedWriter(newFileWriter(employees.csv)))){for(String[]row:data){writer.println(String.join(,,row));}System.out.println(CSV 文件生成成功);}catch(IOExceptione){e.printStackTrace();}}}4.3 日志写入工具类importjava.io.BufferedWriter;importjava.io.FileWriter;importjava.io.IOException;importjava.io.PrintWriter;importjava.time.LocalDateTime;importjava.time.format.DateTimeFormatter;publicclassLogger{privatestaticfinalDateTimeFormatterFORMATTERDateTimeFormatter.ofPattern(yyyy-MM-dd HH:mm:ss);privatefinalStringlogFile;publicLogger(StringlogFile){this.logFilelogFile;}publicvoidlog(Stringlevel,Stringmessage){StringtimestampLocalDateTime.now().format(FORMATTER);StringlogLineString.format([%s] [%s] %s,timestamp,level,message);try(PrintWriterwriternewPrintWriter(newBufferedWriter(newFileWriter(logFile,true)))){writer.println(logLine);}catch(IOExceptione){e.printStackTrace();}}publicstaticvoidmain(String[]args){LoggerloggernewLogger(app.log);logger.log(INFO,应用启动);logger.log(WARN,内存使用率偏高);logger.log(ERROR,数据库连接失败);}}5. 性能优化与最佳实践5.1 使用缓冲流直接写入文件时每次write()调用都会触发系统调用性能较差。使用BufferedWriter可以显著减少 I/O 次数// 不推荐频繁系统调用try(FileWriterwriternewFileWriter(data.txt)){for(inti0;i10000;i){writer.write(line i\n);}}// 推荐使用缓冲try(BufferedWriterwriternewBufferedWriter(newFileWriter(data.txt))){for(inti0;i10000;i){writer.write(line i\n);}}5.2 合理设置缓冲区大小BufferedWriter默认缓冲区大小为 8KB可以根据实际场景调整// 设置 32KB 缓冲区BufferedWriterwriternewBufferedWriter(newFileWriter(large.txt),32*1024);5.3 使用 try-with-resourcesJava 7 引入的 try-with-resources 语法可以自动关闭资源避免资源泄漏// 推荐自动关闭try(BufferedWriterwriternewBufferedWriter(newFileWriter(data.txt))){writer.write(content);}catch(IOExceptione){e.printStackTrace();}5.4 指定字符编码在 Java 11 之前FileWriter默认使用平台编码跨平台时可能出现乱码。建议显式指定编码// Java 11 推荐try(FileWriterwriternewFileWriter(data.txt,StandardCharsets.UTF_8)){writer.write(中文内容);}// 通用方案try(OutputStreamWriterwriternewOutputStreamWriter(newFileOutputStream(data.txt),StandardCharsets.UTF_8)){writer.write(中文内容);}6. 常见问题与注意事项6.1 忘记关闭流忘记调用close()会导致资源泄漏和缓冲区数据丢失。务必使用 try-with-resources 或 finally 块确保关闭。6.2 编码不一致导致乱码写入和读取时使用的编码必须一致否则会出现乱码。建议统一使用 UTF-8。6.3 flush 与 close 的区别flush()将缓冲区数据强制写入目标流仍然可用close()先 flush 再关闭流释放资源6.4 追加模式FileWriter构造器的第二个参数控制是否追加// 覆盖模式默认newFileWriter(data.txt);// 追加模式newFileWriter(data.txt,true);7. 总结JavaWriter体系为字符输出提供了强大而灵活的支持。核心要点总结如下Writer是字符输出流的抽象基类直接操作 Unicode 字符常用实现类包括FileWriter、BufferedWriter、OutputStreamWriter、StringWriter、PrintWriter等使用BufferedWriter包装可以显著提升写入性能优先使用 try-with-resources 确保资源正确关闭显式指定字符编码推荐 UTF-8避免乱码问题根据场景选择合适的实现类文件写入用FileWriter格式化输出用PrintWriter内存操作用StringWriter或CharArrayWriter掌握这些知识后你就能在 Java 项目中游刃有余地处理各种文本输出需求了。