掌握 Java OutputStreamWriter：字符转字节桥梁与实战示例

Java OutputStreamWriter 类

OutputStreamWriter 位于 java.io，作为桥梁将字符数据转为字节数据。继承抽象 Writer，配合 FileOutputStream 等字节流工作。

因 Unicode 字符可能跨多字节，OutputStreamWriter 确保写入字节流时正确应用字符编码。

创建 OutputStreamWriter

导入必要类：

import java.io.OutputStreamWriter;
import java.io.FileOutputStream;
import java.nio.charset.Charset;

实例化 FileOutputStream 目标文件，再包装为 OutputStreamWriter。默认构造器用平台默认字符集，可显式设 UTF-8 或 UTF-16 保证跨环境一致：

// 默认字符集
OutputStreamWriter writer = new OutputStreamWriter(new FileOutputStream("output.txt"));
// 显式 UTF-8
OutputStreamWriter writerUtf8 = new OutputStreamWriter(
    new FileOutputStream("output_utf8.txt"), Charset.forName("UTF-8"));

OutputStreamWriter 关键方法

write() 方法

• write(int c) – 写单字符
• write(char[] cbuf) – 写字符数组
• write(String str) – 写字符串

示例：写文本到文件

import java.io.FileOutputStream;
import java.io.OutputStreamWriter;
public class Main {
    public static void main(String[] args) {
        String data = "This is a line of text inside the file.";
        try {
            FileOutputStream fileOut = new FileOutputStream("output.txt");
            OutputStreamWriter writer = new OutputStreamWriter(fileOut, Charset.forName("UTF-8"));
            writer.write(data);
            writer.flush();
            writer.close();
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

运行后创建 output.txt，内容：

This is a line of text inside the file.

getEncoding() 方法

用 getEncoding() 获取当前使用的字符集：

FileOutputStream file = new FileOutputStream("output.txt");
OutputStreamWriter defaultWriter = new OutputStreamWriter(file);
OutputStreamWriter utf8Writer = new OutputStreamWriter(file, Charset.forName("UTF-8"));
System.out.println("Default encoding: " + defaultWriter.getEncoding());
System.out.println("UTF-8 encoding: " + utf8Writer.getEncoding());

输出

Default encoding: Cp1252
UTF-8 encoding: UTF-8

未指定字符集时返回平台默认。显式设置保证行为一致。

提示： 精确控制用 Charset.forName()。详见官方 Java Charset API。

close() 方法

始终调用 close() 释放系统资源。关闭后 writer 不可再用。

其他实用方法

完整参考见官方 Java OutputStreamWriter Javadoc。