FileOutputStream写中文易乱码因其只处理字节且依赖系统默认编码;推荐用Files.write()或BufferedWriter+Files.newBufferedWriter(),它们自动处理编码、目录创建和资源管理。

FileOutputStream 不适合直接处理文本文件,它只负责写入原始字节 —— 如果你用它写中文字符串却没指定编码,大概率出现乱码;而所谓“常用文件操作类库”,其实多数是帮你绕过 FileOutputStream 的底层细节。
为什么 FileOutputStream 写中文容易乱码
因为 FileOutputStream 是 OutputStream 子类,只认 byte[],不理解字符编码。调用 write(String.getBytes()) 时,若未显式传入编码(如 "UTF-8"),会走平台默认编码(Windows 常为 GBK),Linux/macOS 多为 UTF-8,一换环境就出问题。
常见错误现象:
FileOutputStream fos = new FileOutputStream("a.txt");
fos.write("你好".getBytes()); // 没指定编码 → 依赖系统默认 → 不可移植
- 必须写成
"你好".getBytes(StandardCharsets.UTF_8)才安全 - 更推荐跳过
FileOutputStream,直接用带编码的高层 API - 它无法自动创建父目录(
new File("dir/a.txt").getParentFile().mkdirs()得手动补)
Files.write() 是最简替代方案(Java 7+)
Files.write() 封装了 FileOutputStream + 编码 + 目录创建,一行顶原来五行,且默认覆盖写入:
Files.write(Paths.get("out.txt"), "你好世界".getBytes(StandardCharsets.UTF_8));
如果要追加写入,加 StandardOpenOption.APPEND:
立即学习“Java免费学习笔记(深入)”;
LANUX V1.0 蓝脑商务网站系统 适用于网店、公司宣传自己的品牌和产品。 系统在代码、页面方面设计简约,浏览和后台管理操作效率高。 此版本带可见即可得的html编辑器, 方便直观添加和编辑要发布的内容。 安装: 1.解压后,更换logo、分类名称、幻灯片的图片及名称和链接、联系我们等等页面。 2.将dbconfig.php里面的数据库配置更改为你的mysql数据库配置 3.将整个文件夹上传至
Files.write(Paths.get("log.txt"), "新日志\n".getBytes(StandardCharsets.UTF_8),
StandardOpenOption.CREATE, StandardOpenOption.APPEND);
- 自动创建不存在的父目录(只要权限允许)
- 不支持按行写入(比如没有内置换行符处理),需自己拼
"\n" - 对大文件慎用 —— 整个内容会先加载进内存再写入
BufferedWriter + Files.newBufferedWriter() 适合文本流场景
当你要频繁写多行、或需要格式化输出(如 printf)、或配合 try-with-resources 自动关闭时,这是比裸用 FileOutputStream 更自然的选择:
try (BufferedWriter writer = Files.newBufferedWriter(
Paths.get("data.txt"), StandardCharsets.UTF_8)) {
writer.write("第一行");
writer.newLine();
writer.write("第二行");
}
- 内部仍用
FileOutputStream,但你完全不用碰字节和编码转换 -
newBufferedWriter()默认是覆盖写入;追加需加StandardOpenOption.APPEND - 注意:
write(String)不自动换行,newLine()才写系统适配的换行符(\r\n或\n)
Apache Commons IO 和 Guava 的定位差异
这两个库不是为了“取代” FileOutputStream,而是补足 JDK 文件操作的常见缺失:
-
FileUtils.writeStringToFile(file, content, "UTF-8")(Commons IO)—— 简单粗暴,但已标记为@Deprecated,新项目建议用Files.write() -
Files.asCharSink(file, Charsets.UTF_8).write(content)(Guava)—— 类似Files.newBufferedWriter(),但 Guava 20+ 已废弃Files工具类,转向 JDK 原生 - 真正值得留下的功能是:批量复制、计算校验和、读取全部行到
List、安全删除非空目录等 —— 这些 JDK 还没原生支持
复杂点在于:很多老项目还在用 FileOutputStream + OutputStreamWriter 手动组合,这种写法没错,但容易漏关流、漏 flush、漏指定编码。现在 JDK 原生已有足够好用的替代,没必要再手撸底层流链路。









