Java入门项目：简易文本编辑器开发教程

本文深入剖析Java初学者使用Swing开发简易文本编辑器时最常踩坑的核心细节：从UTF-8编码显式指定以根治中文乱码，到拦截WINDOW_CLOSING事件实现精准的未保存提示；从JFileChooser双重校验确保.txt文件限制不被绕过，到Ctrl+S保存失败的三大静默陷阱排查；再到贯穿始终的EDT线程安全意识——每一处看似“能跑就行”的功能背后，都藏着决定项目是否真正健壮、可维护的关键实践。这不仅是一份文本编辑器实现指南，更是通往专业Swing开发的必经实战课。

Java初学者用 Swing 写文本编辑器，能跑起来不崩溃是第一关；真正卡住的不是“怎么显示窗口”，而是JTextArea和FileReader/FileWriter配合时的编码、换行、光标位置、未保存提示这些细节。

为什么 JTextArea 读文件后中文乱码？

Swing 本身不处理文件编码，JTextArea 默认用系统默认字符集（Windows 是 GBK，macOS/Linux 通常是 UTF-8），但你用 FileReader 读取时没指定编码，就会出问题。

• 别用 new FileReader(file) —— 它隐式使用平台默认编码，不可控
• 改用 Files.readAllLines(path, StandardCharsets.UTF_8) 或 new InputStreamReader(new FileInputStream(file), "UTF-8")
• 写入时同理：用 Files.write(path, lines, StandardCharsets.UTF_8)，别用 FileWriter（它也不支持显式编码）

如何实现「关闭前提示是否保存」？

JFrame 的 setDefaultCloseOperation(JFrame.DO_NOTHING_ON_CLOSE) 是必须的，否则 windowClosing 事件根本不会触发。

• 监听 WindowEvent.WINDOW_CLOSING，而不是 WINDOW_CLOSED（后者已无法拦截）
• 用 textArea.getText().equals(currentContent) 判断是否修改过 —— 注意：初始加载后要立刻把 currentContent 设为当前文本，否则一打开就提示“内容已更改”
• 弹窗用 JOptionPane.showConfirmDialog，返回值是 JOptionPane.YES_OPTION、NO_OPTION 或 CANCEL_OPTION，别直接比数字

JFileChooser 怎么限制只显示 .txt 文件？

靠 setFileFilter 不够，用户仍可手动输入任意扩展名或切换“所有文件”；必须在 approveSelection() 里二次校验。

• 先加过滤器：fileChooser.setFileFilter(new FileNameExtensionFilter("纯文本文件 (*.txt)", "txt"))
• 再重写对话框对象：

  fileChooser.setDialogType(JFileChooser.OPEN_DIALOG);
  fileChooser.addActionListener(e -> {
      if (JFileChooser.APPROVE_SELECTION.equals(e.getActionCommand())) {
          File f = fileChooser.getSelectedFile();
          if (f != null && !f.getName().toLowerCase().endsWith(".txt")) {
              JOptionPane.showMessageDialog(null, "请只选择 .txt 文件");
              fileChooser.cancelSelection();
          }
      }
  });

Ctrl+S 保存失败却没报错？检查这三点

常见静默失败不是逻辑错，而是异常被吞了或路径没权限。

• 确保 try-catch 里至少 e.printStackTrace() 或弹窗提示 —— Swing 中空 catch 块等于埋雷
• 如果 currentFile 为 null（即首次保存），必须调用 fileChooser.showSaveDialog()，且要检查返回值是否为 JFileChooser.APPROVE_OPTION
• 注意 Windows 下路径含中文、空格时没问题，但若 File 对象指向的是只读目录（如 C:\Program Files），Files.write 会抛 AccessDeniedException，得提前 f.canWrite() 判断

最易忽略的是：Swing 的 UI 更新必须在 EDT（事件分发线程）中进行。所有 setText、append、showMessageDialog 都得确认上下文 —— 如果从 SwingWorker 或普通线程里调用，要用 SwingUtilities.invokeLater 包一层，否则偶尔卡死、UI 不刷新、甚至 NullPointerException。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。