初学首选 Swing:JDK 自带、零配置即可运行 JFrame + JTextArea + JButton;JavaFX 需 JDK 11+ 并手动配置 --module-path 和 --add-modules,否则报 NoClassDefFoundError。

用 Swing 还是 JavaFX?选错框架会卡在第一步
Java GUI 备忘录工具起步就卡在技术栈选择上。Swing 虽然老旧但 JDK 自带、零依赖,JavaFX 界面现代却需额外配置模块(JDK 11+ 默认不包含)。新手直接用 JavaFX 容易遇到 java.lang.NoClassDefFoundError: javafx/application/Application,尤其在 IDE 中未正确添加 --module-path 和 --add-modules 参数时。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 初学首选
Swing:写一个JFrame+JTextArea+JButton就能跑起来,不用配模块路径 - 若坚持用
JavaFX,确认 JDK 版本 ≥ 11 后,必须在运行参数中显式指定:--module-path /path/to/javafx-sdk/lib --add-modules javafx.controls,javafx.fxml - 避免混用:不要在一个窗口里同时用
JFXPanel嵌套 JavaFX 组件——对备忘录这种简单工具纯属增加复杂度
数据存哪?别把备忘录写成内存玩具
只用 ArrayList 存笔记,关掉程序就丢数据,这不是“管理工具”,是“临时草稿板”。真实可用的备忘录至少得落盘,但又不能一上来就搞数据库——SQLite 或 H2 对初级项目属于过度设计。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 优先用
FileWriter+BufferedReader写纯文本文件,每条笔记按行存储(如2024-05-20 14:30|买牛奶|紧急),解析简单、调试直观 - 若想支持标题/内容分离,用
Properties类保存键值对(注意编码设为UTF-8,否则中文乱码) - 避开
ObjectOutputStream:序列化文件不可读、跨版本不兼容、还容易因类结构变动导致InvalidClassException
增删改查逻辑怎么组织?别让事件监听器变成意大利面条
把所有按钮点击逻辑全塞进 actionPerformed 方法里,几十行 if-else 套嵌套,后续加个“按日期筛选”功能就得重读三遍代码。GUI 交互逻辑必须分层。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 用独立方法封装操作:比如
saveNote()、deleteSelectedNote()、loadNotesFromFile(),每个方法只做一件事 -
JList或JTable显示笔记时,绑定一个DefaultListModel或AbstractTableModel,增删改都通过模型操作,UI 自动响应 - 删除功能务必加确认弹窗:
JOptionPane.showConfirmDialog(..., "确定删除?", ..., JOptionPane.YES_NO_OPTION),否则手抖点错就真没了
字体、中文、换行——界面细节不处理,用户第一眼就劝退
默认 JTextArea 用的是系统等宽字体,中文显示发虚;输入长文本不换行,横向滚动条拉到怀疑人生;复制粘贴中文出现乱码……这些不是“锦上添花”,是基础可用性门槛。
实操建议:
立即学习“Java免费学习笔记(深入)”;
- 显式设置字体:
textArea.setFont(new Font("Microsoft YaHei", Font.PLAIN, 14))(Windows)或"PingFang SC"(macOS) - 开启自动换行:
textArea.setLineWrap(true)+textArea.setWrapStyleWord(true) - 文件读写全程指定编码:
new OutputStreamWriter(new FileOutputStream(file), StandardCharsets.UTF_8)
public class MemoApp {
private JTextArea contentArea;
private DefaultListModel listModel;
private JList noteList;
public void initUI() {
JFrame frame = new JFrame("个人备忘录");
contentArea = new JTextArea();
contentArea.setFont(new Font("Microsoft YaHei", Font.PLAIN, 14));
contentArea.setLineWrap(true);
contentArea.setWrapStyleWord(true);
listModel = new DefaultListModel<>();
noteList = new JList<>(listModel);
noteList.setSelectionMode(ListSelectionModel.SINGLE_SELECTION);
JButton saveBtn = new JButton("保存");
saveBtn.addActionListener(e -> saveNote());
// ... 其他组件组装
frame.add(new JScrollPane(noteList), BorderLayout.WEST);
frame.add(new JScrollPane(contentArea), BorderLayout.CENTER);
frame.add(saveBtn, BorderLayout.SOUTH);
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
frame.pack();
frame.setVisible(true);
}
private void saveNote() {
String text = contentArea.getText().trim();
if (!text.isEmpty()) {
listModel.addElement(text);
contentArea.setText(""); // 清空输入区
}
}
}
Swing 的坑不在语法,而在那些没显式设置就默认失效的细节:字体、换行、编码、模型绑定。写完能跑只是起点,用户愿意天天打开用,才说明它真的成了工具。










