1. 引言在 Java 的 I/O 体系中FileOutputStream是最基础、最常用的字节输出流之一。它用于将字节数据写入文件是文件写入操作的基石。无论是写日志、导出数据还是生成文件FileOutputStream都扮演着重要角色。本文将带你从零开始全面掌握FileOutputStream的使用方法、核心原理、常见陷阱与最佳实践。2. FileOutputStream 概述2.1 什么是 FileOutputStreamFileOutputStream是java.io包下的一个类继承自OutputStream专门用于向文件中写入字节数据。它属于字节流适合处理二进制文件如图片、音频以及文本文件。2.2 类继承关系java.lang.Object └── java.io.OutputStream └── java.io.FileOutputStream2.3 核心特点字节流以字节为单位写入数据文件输出只能写入文件不能读取覆盖/追加默认覆盖原文件可指定追加模式非线程安全多线程写入同一流需要外部同步3. 构造方法详解FileOutputStream提供了多种构造方法满足不同场景需求。3.1 常用构造方法构造方法说明FileOutputStream(String name)按文件路径创建覆盖写入FileOutputStream(String name, boolean append)指定是否追加写入FileOutputStream(File file)按 File 对象创建覆盖写入FileOutputStream(File file, boolean append)指定 File 对象和追加模式FileOutputStream(FileDescriptor fdObj)基于文件描述符创建3.2 构造方法示例// 方式一按路径创建覆盖写入FileOutputStreamfos1newFileOutputStream(data.txt);// 方式二按路径创建追加写入FileOutputStreamfos2newFileOutputStream(data.txt,true);// 方式三按 File 对象创建FilefilenewFile(data.txt);FileOutputStreamfos3newFileOutputStream(file);// 方式四File 对象 追加模式FileOutputStreamfos4newFileOutputStream(file,true);3.3 注意事项如果文件不存在构造时会自动创建文件如果文件存在且为覆盖模式会清空原内容如果文件路径无效或没有权限会抛出FileNotFoundException4. 核心方法详解4.1 主要方法一览方法说明write(int b)写入单个字节write(byte[] b)写入字节数组write(byte[] b, int off, int len)写入字节数组的指定部分flush()刷新缓冲区继承自 OutputStreamclose()关闭流并释放资源getFD()获取文件描述符getChannel()获取文件通道NIO4.2 写入单个字节FileOutputStreamfosnewFileOutputStream(data.txt);fos.write(65);// 写入字符 Afos.close();4.3 写入字节数组FileOutputStreamfosnewFileOutputStream(data.txt);StringcontentHello, Java!;fos.write(content.getBytes());fos.close();4.4 写入指定范围FileOutputStreamfosnewFileOutputStream(data.txt);byte[]dataHello, Java!.getBytes();fos.write(data,0,5);// 只写入前 5 个字节 Hellofos.close();5. 完整示例写入文本文件下面是一个完整的示例演示如何使用FileOutputStream写入文本文件。importjava.io.FileOutputStream;importjava.io.IOException;publicclassFileOutputStreamExample{publicstaticvoidmain(String[]args){StringcontentHello, FileOutputStream!\n这是第二行内容。;try(FileOutputStreamfosnewFileOutputStream(output.txt)){// 将字符串转为字节数组并写入fos.write(content.getBytes());System.out.println(文件写入成功);}catch(IOExceptione){e.printStackTrace();}}}运行结果文件写入成功output.txt文件内容Hello, FileOutputStream! 这是第二行内容。6. 追加写入模式默认情况下FileOutputStream会覆盖原文件内容。如果需要追加内容需要将构造方法的append参数设为true。importjava.io.FileOutputStream;importjava.io.IOException;publicclassAppendExample{publicstaticvoidmain(String[]args){StringnewContent追加的新内容\n;try(FileOutputStreamfosnewFileOutputStream(output.txt,true)){fos.write(newContent.getBytes());System.out.println(内容追加成功);}catch(IOExceptione){e.printStackTrace();}}}7. 写入二进制文件FileOutputStream同样适用于写入二进制数据如图片、音频等。importjava.io.FileOutputStream;importjava.io.IOException;publicclassBinaryWriteExample{publicstaticvoidmain(String[]args){byte[]binaryData{0x48,0x65,0x6C,0x6C,0x6F};// Hellotry(FileOutputStreamfosnewFileOutputStream(binary.dat)){fos.write(binaryData);System.out.println(二进制文件写入成功);}catch(IOExceptione){e.printStackTrace();}}}8. 结合 BufferedOutputStream 提升性能直接使用FileOutputStream写入大量数据时每次write都会触发系统调用性能较低。推荐结合BufferedOutputStream使用通过缓冲区减少 I/O 次数。importjava.io.BufferedOutputStream;importjava.io.FileOutputStream;importjava.io.IOException;publicclassBufferedWriteExample{publicstaticvoidmain(String[]args){StringBuildersbnewStringBuilder();for(inti0;i10000;i){sb.append(第 ).append(i).append( 行数据\n);}try(BufferedOutputStreambosnewBufferedOutputStream(newFileOutputStream(large.txt))){bos.write(sb.toString().getBytes());System.out.println(大数据写入成功);}catch(IOExceptione){e.printStackTrace();}}}9. 结合 OutputStreamWriter 写入文本如果需要指定字符编码写入文本可以结合OutputStreamWriter使用。importjava.io.FileOutputStream;importjava.io.IOException;importjava.io.OutputStreamWriter;importjava.nio.charset.StandardCharsets;publicclassWriterExample{publicstaticvoidmain(String[]args){Stringcontent中文内容使用 UTF-8 编码写入;try(OutputStreamWriterwriternewOutputStreamWriter(newFileOutputStream(utf8.txt),StandardCharsets.UTF_8)){writer.write(content);System.out.println(UTF-8 文件写入成功);}catch(IOExceptione){e.printStackTrace();}}}10. 常见异常与处理10.1 FileNotFoundException当文件路径无效、文件是目录或没有写入权限时抛出。try{FileOutputStreamfosnewFileOutputStream(/nonexistent/dir/data.txt);}catch(FileNotFoundExceptione){System.err.println(文件不存在或路径无效e.getMessage());}10.2 IOException写入过程中发生 I/O 错误时抛出。try{FileOutputStreamfosnewFileOutputStream(data.txt);fos.write(test.getBytes());fos.close();}catch(IOExceptione){System.err.println(写入失败e.getMessage());}10.3 异常处理最佳实践使用try-with-resources自动关闭资源不要吞掉异常至少打印日志区分FileNotFoundException和IOException的处理逻辑11. 常见陷阱与注意事项11.1 忘记关闭流不关闭流会导致资源泄漏文件可能无法被其他程序访问。// 错误示范FileOutputStreamfosnewFileOutputStream(data.txt);fos.write(test.getBytes());// 忘记调用 fos.close()// 正确示范使用 try-with-resourcestry(FileOutputStreamfosnewFileOutputStream(data.txt)){fos.write(test.getBytes());}11.2 字符编码问题写入文本时getBytes()默认使用平台默认编码可能导致跨平台乱码。建议显式指定编码。// 不推荐依赖平台默认编码fos.write(content.getBytes());// 推荐显式指定 UTF-8fos.write(content.getBytes(StandardCharsets.UTF_8));11.3 覆盖与追加混淆默认是覆盖模式如果希望保留原内容务必使用追加模式。// 覆盖模式清空原内容FileOutputStreamfos1newFileOutputStream(data.txt);// 追加模式保留原内容FileOutputStreamfos2newFileOutputStream(data.txt,true);11.4 写入性能问题频繁的小数据写入会导致性能低下应使用缓冲流。// 不推荐逐字节写入for(byteb:data){fos.write(b);}// 推荐批量写入fos.write(data);12. 与 FileWriter 的对比对比项FileOutputStreamFileWriter类型字节流字符流适用场景二进制文件、任意数据文本文件编码控制需手动指定依赖默认编码性能配合缓冲流性能好本身有缓冲区灵活性高较低选择建议写入图片、音频等二进制文件 →FileOutputStream写入文本且无需指定编码 →FileWriter写入文本且需指定编码 →FileOutputStreamOutputStreamWriter13. 实战案例文件复制工具综合运用所学知识实现一个简单的文件复制工具。importjava.io.FileInputStream;importjava.io.FileOutputStream;importjava.io.IOException;publicclassFileCopyUtil{publicstaticvoidcopyFile(StringsourcePath,StringdestPath){try(FileInputStreamfisnewFileInputStream(sourcePath);FileOutputStreamfosnewFileOutputStream(destPath)){byte[]buffernewbyte[8192];intbytesRead;while((bytesReadfis.read(buffer))!-1){fos.write(buffer,0,bytesRead);}System.out.println(文件复制成功);}catch(IOExceptione){System.err.println(文件复制失败e.getMessage());}}publicstaticvoidmain(String[]args){copyFile(source.txt,dest.txt);}}14. 总结FileOutputStream是 Java 文件写入的基础工具掌握它的核心用法对理解整个 Java I/O 体系至关重要。本文要点回顾构造方法支持路径/File 对象、覆盖/追加模式核心方法write系列方法完成字节写入性能优化结合BufferedOutputStream提升写入效率编码控制结合OutputStreamWriter指定字符编码资源管理使用 try-with-resources 确保流正确关闭异常处理区分并妥善处理各类 I/O 异常在实际开发中建议根据具体场景选择合适的写入方式并始终关注资源释放与编码一致性。