1. 引言
在 Java 的 I/O 体系中，FileOutputStream是最基础、最常用的字节输出流之一。它用于将字节数据写入文件，是文件写入操作的基石。无论是写日志、导出数据，还是生成文件，FileOutputStream都扮演着重要角色。
本文将带你从零开始，全面掌握FileOutputStream的使用方法、核心原理、常见陷阱与最佳实践。
2. FileOutputStream 概述
2.1 什么是 FileOutputStream
FileOutputStream是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 构造方法示例
// 方式一：按路径创建，覆盖写入FileOutputStreamfos1=newFileOutputStream("data.txt");// 方式二：按路径创建，追加写入FileOutputStreamfos2=newFileOutputStream("data.txt",true);// 方式三：按 File 对象创建Filefile=newFile("data.txt");FileOutputStreamfos3=newFileOutputStream(file);// 方式四：File 对象 + 追加模式FileOutputStreamfos4=newFileOutputStream(file,true);3.3 注意事项
- 如果文件不存在，构造时会自动创建文件
- 如果文件存在且为覆盖模式，会清空原内容
- 如果文件路径无效或没有权限，会抛出
FileNotFoundException
4. 核心方法详解
4.1 主要方法一览
| 方法 | 说明 |
|---|---|
write(int b) | 写入单个字节 |
write(byte[] b) | 写入字节数组 |
write(byte[] b, int off, int len) | 写入字节数组的指定部分 |
flush() | 刷新缓冲区（继承自 OutputStream） |
close() | 关闭流并释放资源 |
getFD() | 获取文件描述符 |
getChannel() | 获取文件通道（NIO） |
4.2 写入单个字节
FileOutputStreamfos=newFileOutputStream("data.txt");fos.write(65);// 写入字符 'A'fos.close();4.3 写入字节数组
FileOutputStreamfos=newFileOutputStream("data.txt");Stringcontent="Hello, Java!";fos.write(content.getBytes());fos.close();4.4 写入指定范围
FileOutputStreamfos=newFileOutputStream("data.txt");byte[]data="Hello, Java!".getBytes();fos.write(data,0,5);// 只写入前 5 个字节 "Hello"fos.close();5. 完整示例：写入文本文件
下面是一个完整的示例，演示如何使用FileOutputStream写入文本文件。
importjava.io.FileOutputStream;importjava.io.IOException;publicclassFileOutputStreamExample{publicstaticvoidmain(String[]args){Stringcontent="Hello, FileOutputStream!\n这是第二行内容。";try(FileOutputStreamfos=newFileOutputStream("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(FileOutputStreamfos=newFileOutputStream("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};// "Hello"try(FileOutputStreamfos=newFileOutputStream("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){StringBuildersb=newStringBuilder();for(inti=0;i<10000;i++){sb.append("第 ").append(i).append(" 行数据\n");}try(BufferedOutputStreambos=newBufferedOutputStream(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(OutputStreamWriterwriter=newOutputStreamWriter(newFileOutputStream("utf8.txt"),StandardCharsets.UTF_8)){writer.write(content);System.out.println("UTF-8 文件写入成功！");}catch(IOExceptione){e.printStackTrace();}}}10. 常见异常与处理
10.1 FileNotFoundException
当文件路径无效、文件是目录或没有写入权限时抛出。
try{FileOutputStreamfos=newFileOutputStream("/nonexistent/dir/data.txt");}catch(FileNotFoundExceptione){System.err.println("文件不存在或路径无效："+e.getMessage());}10.2 IOException
写入过程中发生 I/O 错误时抛出。
try{FileOutputStreamfos=newFileOutputStream("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 忘记关闭流
不关闭流会导致资源泄漏，文件可能无法被其他程序访问。
// 错误示范FileOutputStreamfos=newFileOutputStream("data.txt");fos.write("test".getBytes());// 忘记调用 fos.close()// 正确示范：使用 try-with-resourcestry(FileOutputStreamfos=newFileOutputStream("data.txt")){fos.write("test".getBytes());}11.2 字符编码问题
写入文本时，getBytes()默认使用平台默认编码，可能导致跨平台乱码。建议显式指定编码。
// 不推荐：依赖平台默认编码fos.write(content.getBytes());// 推荐：显式指定 UTF-8fos.write(content.getBytes(StandardCharsets.UTF_8));11.3 覆盖与追加混淆
默认是覆盖模式，如果希望保留原内容，务必使用追加模式。
// 覆盖模式：清空原内容FileOutputStreamfos1=newFileOutputStream("data.txt");// 追加模式：保留原内容FileOutputStreamfos2=newFileOutputStream("data.txt",true);11.4 写入性能问题
频繁的小数据写入会导致性能低下，应使用缓冲流。
// 不推荐：逐字节写入for(byteb:data){fos.write(b);}// 推荐：批量写入fos.write(data);12. 与 FileWriter 的对比
| 对比项 | FileOutputStream | FileWriter |
|---|---|---|
| 类型 | 字节流 | 字符流 |
| 适用场景 | 二进制文件、任意数据 | 文本文件 |
| 编码控制 | 需手动指定 | 依赖默认编码 |
| 性能 | 配合缓冲流性能好 | 本身有缓冲区 |
| 灵活性 | 高 | 较低 |
选择建议：
- 写入图片、音频等二进制文件 →
FileOutputStream - 写入文本且无需指定编码 →
FileWriter - 写入文本且需指定编码 →
FileOutputStream+OutputStreamWriter
13. 实战案例：文件复制工具
综合运用所学知识，实现一个简单的文件复制工具。
importjava.io.FileInputStream;importjava.io.FileOutputStream;importjava.io.IOException;publicclassFileCopyUtil{publicstaticvoidcopyFile(StringsourcePath,StringdestPath){try(FileInputStreamfis=newFileInputStream(sourcePath);FileOutputStreamfos=newFileOutputStream(destPath)){byte[]buffer=newbyte[8192];intbytesRead;while((bytesRead=fis.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 异常
在实际开发中，建议根据具体场景选择合适的写入方式，并始终关注资源释放与编码一致性。
