Java记事本开发教程详解

本文详细讲解了如何使用Java Swing开发一个功能完整、健壮可靠的原生记事本程序，强调避开JavaFX的兼容性陷阱，聚焦于JFrame、JTextArea与JScrollPane等核心组件的正确组合；涵盖关键实践如启用智能换行、用DocumentListener精准监听文本修改状态、统一UTF-8编码读写以杜绝乱码和换行符问题、严谨区分“保存”与“另存为”的逻辑并借助currentFile字段避免空指针与误写，并提醒关闭前提示、保存后及时重置修改标记等易被忽视却至关重要的细节——这不仅是一份入门教程，更是面向真实工程场景的Swing桌面开发避坑指南。

用 Swing 搭建基础记事本界面，别碰 JavaFX（除非明确要求）

Java 原生桌面记事本最稳妥的起点是 Swing，它内置、跨平台、无需额外依赖。直接用 JFrame + JTextArea + JScrollPane 就能跑起来，JMenuBar 和 JMenuItem 处理“文件”“编辑”菜单。别一上来就查 JavaFX——它默认不打包进 JRE 8/11，且 WebView 或 Media 等模块在 JDK 17+ 已移除，徒增兼容性问题。

关键点：

• JTextArea 要设 setLineWrap(true) 和 setWrapStyleWord(true)，否则长行直接撑破窗口
• 菜单项绑定动作必须用 addActionListener，不是 addMouseListener（后者响应位置，不是点击语义）
• 窗口关闭要显式调用 setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE)，再自己监听 WINDOW_CLOSING 事件判断是否保存，否则用户点叉直接退出、内容白写

FileReader/FileWriter 读写文本？小心编码乱码和换行丢失

用 FileReader 和 FileWriter 是最简路径，但它们**默认使用系统平台编码**（Windows 是 GBK，Linux/macOS 是 UTF-8），打开别人发来的 UTF-8 文件会变乱码；而且它们不处理换行符标准化：\r\n（Windows）、\n（Unix）、\r（老 Mac）全照单读入，显示时可能缺行或空行爆炸。

正确做法是统一用带编码参数的 InputStreamReader / OutputStreamWriter：

try (FileInputStream fis = new FileInputStream(file);
     InputStreamReader isr = new InputStreamReader(fis, StandardCharsets.UTF_8);
     BufferedReader reader = new BufferedReader(isr)) {
    String line;
    while ((line = reader.readLine()) != null) {
        textArea.append(line + "\n"); // readLine() 自动剥离换行符，需手动补
    }
}

保存时同理，用 OutputStreamWriter 指定 StandardCharsets.UTF_8，避免靠 textArea.getText() 直接写——它保留所有换行符，但不同系统换行符不一致，会导致 Git 提交报 “CRLF will be replaced by LF” 这类警告。

“另存为”和“保存”的逻辑差异：别把未命名文件当已存在文件处理

用户新建文档后第一次点“保存”，本质是“另存为”；只有打开过文件或已执行过“另存为”后，“保存”才应覆盖原路径。核心在于维护一个 File currentFile 字段：

• 初始化为 null
• “打开”成功后赋值为选中的 File
• “另存为”成功后更新该字段
• “保存”操作前先判空：if (currentFile == null) { showSaveDialog(); return; }

漏掉这个判断，会导致新建文档点“保存”时尝试写入 null 路径，抛出 NullPointerException；或者更隐蔽地写入当前工作目录下的 NULL 文件（取决于字符串拼接逻辑）。

监听文本修改状态，避免误丢内容：用 DocumentListener，不是 KeyListener

判断用户是否修改过内容（用于关闭前提示“是否保存”），不能靠监听按键——粘贴、撤销、拖入文本都会绕过 KeyListener。必须监听 JTextArea 底层的 Document：

textArea.getDocument().addDocumentListener(new DocumentListener() {
    public void changedUpdate(DocumentEvent e) { setModified(true); }
    public void insertUpdate(DocumentEvent e) { setModified(true); }
    public void removeUpdate(DocumentEvent e) { setModified(true); }
});

其中 setModified(true) 更新一个布尔标记，并同步设置窗口标题加星号（如 "记事本 - 无标题.txt *"）。注意：不要在监听器里做耗时操作（如实时保存），DocumentEvent 在 EDT 线程触发，卡住会冻结整个 UI。

真实开发中最容易被跳过的，是“保存后重置修改状态”这一步——很多人只在修改时设 true，却忘了在成功写入文件后调用 setModified(false)，结果用户保存完还一直看到星号，以为没生效。

到这里，我们也就讲完了《Java记事本开发教程详解》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！