Java文本编辑器开发实战：利用JFileChooser实现文件读写与乱码修复

Finn

发布时间：2026-10-16 | 3人浏览过

原创

Java文本编辑器的核心交互在于文件的持久化存储与读取。本节将完成菜单中的“新建”、“退出”、“打开”和“保存”功能实现。针对原生IO流在处理多语言字符时产生的乱码隐患，采用显式指定UTF-8编码的包装流方案，确保中英文及特殊字符的准确存取。

目标与准备

当前目标是完善主窗口的事件监听器，使其能够响应用户的菜单点击，调用相应的文件操作方法。核心依赖包括：

JFileChooser：用于弹出系统文件选择对话框。
File：表示选定的文件对象。
InputStreamReader/OutputStreamWriter：用于字节流与字符流的转换，支持指定编码格式。
BufferedReader/BufferedWriter：提供高效的缓冲区读写功能，避免逐字节读写的性能损耗。

第1步：配置文件选择器 (JFileChooser)

在Java Swing应用中，JFileChooser是标准的文件交互组件。为了实现“打开”和“保存”功能，需要在类内部声明实例变量，并在方法中初始化它。

private JFileChooser fileChooser;

初始化和配置对话框参数如下：

fileChooser = new JFileChooser("C:\\\\"); // 默认起始路径为根目录
fileChooser.setApproveButtonToolTipText("确定"); // 设置按钮Tooltip
fileChooser.setDialogTitle("打开文件"); // 设置窗口标题
// showOpenDialog(rootPane) 触发对话框显示

当用户点击“确定”后，可以通过 fileChooser.getSelectedFile() 获取选中的文件路径，并通过判断返回值是否等于 JFileChooser.APPROVE_OPTION 来确认用户确实选择了文件而非取消。

第2步：修复保存功能（写入文件）

原文档中提到直接使用 FileOutputStream 写入内容会导致中文乱码。这是因为字节流不关心字符编码，而在简体中文环境下系统默认编码可能与代码期望不符。

修正后的 saveFile 方法逻辑：

初始化 JFileChooser 并设置标题为“保存文件”。
获取用户选定的 File 对象。
创建带缓冲区的输出流链：FileOutputStream → OutputStreamWriter → BufferedWriter。
关键点：在 OutputStreamWriter 构造中显式传入 "UTF-8" 作为字符集，确保文本以UTF-8格式编码写入磁盘。
将 JTextArea 的内容写入缓冲区并关闭资源。

private void saveFile() {
    File file = null;
    int result = fileChooser.showSaveDialog(rootPane); // 注意使用 showSaveDialog
    
    if(result == JFileChooser.APPROVE_OPTION) {
        file = fileChooser.getSelectedFile();
    }
    
    try {
        // 指定UTF-8编码防止乱码
        OutputStreamWriter write = new OutputStreamWriter(new FileOutputStream(file), "UTF-8");
        BufferedWriter writer = new BufferedWriter(write);
        String content = edit_text_area.getText();
        writer.write(content);
        writer.close();
    } catch (IOException e) {
        e.printStackTrace();
    }
}

第3步：实现打开功能（读取文件）

读取文件时同样需要处理编码问题。原文档尝试按字节读取并转换char，这极易导致多字节字符断裂。推荐使用readLine()逐行读取，并按行追加到文本框，保持换行结构。

修正后的 openFile 方法逻辑：

初始化 JFileChooser，标题为“打开文件”。
验证文件存在且非空。
构建输入流链：FileInputStream → InputStreamReader → BufferedReader。
关键点：InputStreamReader 同样指定 "UTF-8" 解码。
循环调用 reader.readLine()，直到返回 null。每读一行，将其追加到 edit_text_area，并手动添加换行符 '\n'（因为 readLine() 会丢弃原有的换行符）。

private void openFile() {
    File file = null;
    int result = fileChooser.showOpenDialog(rootPane);
    
    if(result == JFileChooser.APPROVE_OPTION) {
        file = fileChooser.getSelectedFile();
    }
    
    // 检查文件有效性
    if(file != null && file.isFile() && file.exists()) {
        BufferedReader reader = null;
        try {
            InputStreamReader inputStreamReader = new InputStreamReader(new FileInputStream(file), "UTF-8");
            reader = new BufferedReader(inputStreamReader);
            
            String readLine;
            while ((readLine = reader.readLine()) != null) {
                // 手动补充换行符，保持排版
                edit_text_area.append(readLine + '\n');
            }
            reader.close();
        } catch (IOException e) {
            e.printStackTrace();
            // 可选：在此处弹出错误提示
        }
    }
}

第4步：整合Menu ActionListener

最后，将所有碎片化的功能汇总到主窗口的 ActionListener 中。根据菜单项的对象引用分发具体的动作。

@Override
public void actionPerformed(ActionEvent e) {
    if (e.getSource() == item_about) {
        new about_Window();
    } else if (e.getSource() == item_word_format) {
        new about_Format();
    } else if (e.getSource() == item_new) {
        // 注意：此处若直接new新实例可能引发主窗口关闭联动Bug，建议复用或重置当前窗口状态
        // 此处仅为示例占位，实际需结合具体窗口生命周期管理
        System.out.println("New Action Triggered"); 
    } else if (e.getSource() == item_exit) {
        this.dispose();
    } else if (e.getSource() == item_open) {
        openFile();
    } else if (e.getSource() == item_save) {
        saveFile();
    }
}

常见问题排查

中文乱码：务必检查所有涉及字符串转换为字节、或字节转换为字符串的IO流步骤。FileReader/FileWriter 等快捷类往往使用平台默认编码，容易出错，建议始终使用指定了 "UTF-8" 的 Reader/Writer 子类。
文件覆盖风险：在saveFile中，如果用户选择了一个已存在的文件，程序会直接覆盖。生产环境建议增加确认弹窗。
资源泄漏：虽然使用了 try-catch-finally 或简单的关闭逻辑，但在Java 7+中推荐使用try-with-resources语法自动关闭资源，代码更简洁安全。