简介：这是一份面向Java初学者与桌面应用开发入门者的实战项目资源，基于J2SE技术栈实现轻量级个人记账管理功能，聚焦GUI编程、SQLite嵌入式数据库操作与事件驱动逻辑整合。资源共173个文件，含46个核心Java源码（覆盖DAO层、UI面板、工具类等）、49个编译后class文件、42个依赖jar包（含SQLite-JDBC驱动）、16个界面图标png及2个SQLite数据库文件，整体压缩包29.45MB，结构清晰，便于逐模块学习调试。已有744人下载学习，适合通过完整可运行项目掌握Swing组件布局、CRUD数据交互、用户输入验证及跨平台打包部署等关键能力。代码注释详实，预览可见RecordDAO、SpendPanel、ChartUtil等典型模块，涵盖账户管理、收支记录、历史查询与图表辅助分析功能，是理解Java桌面应用工程化实践的优质范例。

1. 为什么一个“小小记账本”能成为Java新手绕不开的实战锚点？

不是所有Java项目都叫“小小记账本”，但几乎所有刚写完HelloWorld、学完ArrayList和Scanner、卡在“不知道代码怎么组织成程序”的人，最后都会亲手敲出一个带增删改查、能存本地文件、启动就弹窗的记账本——它不炫技，不连数据库，不套Spring，却把面向对象设计、IO流、Swing/AWT界面、数据持久化、异常处理这五根Java主干全串起来了。你可能在蓝桥杯模拟题里见过“记录每日收支”的需求，在Java面试题中被问过“如何保证金额精度”或“多线程下如何避免重复记账”，甚至在IDEA里反复调试FileWriter编码乱码问题到凌晨两点……这些真实痛点，全藏在这个看似简单的项目里。它不是玩具，而是你从语法练习走向工程思维的第一块真实跳板：没有Maven依赖冲突，不涉及分布式事务，但每一步都得自己扛——文件读写失败怎么兜底？日期格式输错怎么提示？删除前要不要二次确认？这些细节，才是Java工程师真正开始“写程序”而不是“抄代码”的分水岭。

2. 用纯Java+Swing搭起最小可用记账本：从零跑通核心流程

2.1 为什么选Swing而不是JavaFX或Web？——轻量、可控、无额外依赖

很多新手一上来就想用Spring Boot搭个网页版记账本，结果卡在Tomcat配置、Maven依赖冲突、前端路由上，三天没写一行业务逻辑。而“小小记账本”的原始定位，就是脱离框架、直面JDK原生能力。Swing虽老，但JDK 8+自带，无需额外引入；组件稳定（JFrame、JTable、JOptionPane），事件模型清晰（ActionListener）；最重要的是——它强制你思考“界面状态怎么和数据对象同步”。比如：用户点击“添加”按钮后，是直接往JTable的DefaultTableModel里塞新行，还是先创建Transaction对象、再调用addRow()？这个选择背后，就是MVC分层意识的萌芽。我一般会禁用JavaFX（需额外模块）、拒绝Web方案（引入Servlet容器即失焦），就用javax.swing.*和java.io.*两个包打完全场——目标明确：练手，不是炫技。

2.2 三步跑通：定义实体 → 实现文件持久化 → 绑定界面交互

定义核心实体类：Transaction与AccountBook

// Transaction.java —— 每一笔收支的原子单位 public class Transaction { private String date; // 格式：yyyy-MM-dd，避免Date类时区陷阱 private String category; // 收入/餐饮/交通/娱乐等 private double amount; // 用double需谨慎！实际项目应改用BigDecimal，此处为简化教学 private String remark; // 备注，可为空 // 构造方法、getter/setter省略（IDEA可自动生成） public Transaction(String date, String category, double amount, String remark) { this.date = date; this.category = category; this.amount = amount; this.remark = remark; } }

// AccountBook.java —— 记账本容器，管理Transaction列表及文件操作 import java.io.*; import java.time.LocalDate; import java.time.format.DateTimeFormatter; import java.util.*; public class AccountBook { private List<Transaction> transactions; private static final String DATA_FILE = "account_data.txt"; // 纯文本存储，不依赖数据库 private static final DateTimeFormatter FORMATTER = DateTimeFormatter.ofPattern("yyyy-MM-dd"); public AccountBook() { this.transactions = new ArrayList<>(); loadFromFile(); // 启动时自动加载历史数据 } // 从文件读取：按行解析，字段用|分隔（如：2024-05-20|餐饮|45.5|外卖） public void loadFromFile() { try (BufferedReader reader = new BufferedReader(new FileReader(DATA_FILE))) { String line; while ((line = reader.readLine()) != null) { String[] parts = line.split("\\|", -1); // -1保留空字段 if (parts.length == 4) { Transaction t = new Transaction( parts[0].trim(), parts[1].trim(), Double.parseDouble(parts[2].trim()), parts[3].trim() ); transactions.add(t); } } } catch (FileNotFoundException e) { // 文件不存在是正常情况，首次运行时创建空文件 saveToFile(); // 写入空文件，避免后续读取报错 } catch (IOException | NumberFormatException e) { System.err.println("加载数据失败：" + e.getMessage()); } } // 保存到文件：覆盖写入，简单粗暴 public void saveToFile() { try (PrintWriter writer = new PrintWriter(new FileWriter(DATA_FILE))) { for (Transaction t : transactions) { writer.println(String.format("%s|%s|%.2f|%s", t.getDate(), t.getCategory(), t.getAmount(), t.getRemark())); } } catch (IOException e) { System.err.println("保存数据失败：" + e.getMessage()); } } // 提供业务方法 public void addTransaction(Transaction t) { transactions.add(t); saveToFile(); // 每次操作立即落盘，牺牲性能换可靠性（小数据量够用） } public List<Transaction> getAllTransactions() { return new ArrayList<>(transactions); // 返回副本，避免外部修改原始列表 } public void deleteTransaction(int index) { if (index >= 0 && index < transactions.size()) { transactions.remove(index); saveToFile(); } } }

关键参数说明：

• DATA_FILE设为相对路径account_data.txt，程序运行目录下自动生成，无需手动创建；
• split("\\|", -1)中-1参数确保末尾空字段（如备注为空）不被丢弃；
• %.2f格式化输出强制金额保留两位小数，避免double显示45.49999999999999这类玄学问题；
• new ArrayList<>(transactions)返回副本而非引用，是Java集合操作的血泪经验——防止UI层误改底层数据。

Swing界面搭建：用JTable展示+JDialog录入

// MainFrame.java —— 主窗口 import javax.swing.*; import javax.swing.table.DefaultTableModel; import java.awt.*; import java.awt.event.ActionEvent; import java.awt.event.ActionListener; import java.time.LocalDate; import java.time.format.DateTimeFormatter; public class MainFrame extends JFrame { private AccountBook book; private JTable table; private DefaultTableModel tableModel; private JButton addButton, deleteButton; public MainFrame() { this.book = new AccountBook(); initUI(); loadDataToTable(); } private void initUI() { setTitle("小小记账本"); setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); setLayout(new BorderLayout()); // 表格区域 String[] columns = {"日期", "类别", "金额", "备注"}; tableModel = new DefaultTableModel(columns, 0) { @Override public boolean isCellEditable(int row, int column) { return false; // 表格只读，编辑走弹窗 } }; table = new JTable(tableModel); JScrollPane scrollPane = new JScrollPane(table); add(scrollPane, BorderLayout.CENTER); // 按钮面板 JPanel buttonPanel = new JPanel(new FlowLayout()); addButton = new JButton("添加"); deleteButton = new JButton("删除"); buttonPanel.add(addButton); buttonPanel.add(deleteButton); add(buttonPanel, BorderLayout.SOUTH); // 事件绑定 addButton.addActionListener(e -> showAddDialog()); deleteButton.addActionListener(e -> deleteSelectedRow()); pack(); setLocationRelativeTo(null); setVisible(true); } private void loadDataToTable() { tableModel.setRowCount(0); // 清空现有数据 for (Transaction t : book.getAllTransactions()) { tableModel.addRow(new Object[]{ t.getDate(), t.getCategory(), t.getAmount(), t.getRemark() }); } } private void showAddDialog() { JDialog dialog = new JDialog(this, "添加记账", true); dialog.setLayout(new GridLayout(5, 2, 5, 5)); dialog.setSize(300, 200); JLabel dateLabel = new JLabel("日期（yyyy-MM-dd）："); JTextField dateField = new JTextField(LocalDate.now().format(DateTimeFormatter.ISO_DATE)); JLabel categoryLabel = new JLabel("类别："); JTextField categoryField = new JTextField("餐饮"); JLabel amountLabel = new JLabel("金额："); JTextField amountField = new JTextField(); JLabel remarkLabel = new JLabel("备注："); JTextField remarkField = new JTextField(); JButton confirmButton = new JButton("确定"); confirmButton.addActionListener(e -> { try { String date = dateField.getText().trim(); String category = categoryField.getText().trim(); double amount = Double.parseDouble(amountField.getText().trim()); String remark = remarkField.getText().trim(); if (date.isEmpty() || category.isEmpty() || amount <= 0) { JOptionPane.showMessageDialog(dialog, "日期、类别、金额必填且金额>0！"); return; } book.addTransaction(new Transaction(date, category, amount, remark)); loadDataToTable(); // 刷新表格 dialog.dispose(); } catch (NumberFormatException ex) { JOptionPane.showMessageDialog(dialog, "金额必须是数字！"); } }); dialog.add(dateLabel); dialog.add(dateField); dialog.add(categoryLabel); dialog.add(categoryField); dialog.add(amountLabel); dialog.add(amountField); dialog.add(remarkLabel); dialog.add(remarkField); dialog.add(new JLabel()); dialog.add(confirmButton); dialog.setLocationRelativeTo(this); dialog.setVisible(true); } private void deleteSelectedRow() { int selectedRow = table.getSelectedRow(); if (selectedRow == -1) { JOptionPane.showMessageDialog(this, "请先选择要删除的记录！"); return; } if (JOptionPane.showConfirmDialog(this, "确定删除该笔记录？", "确认删除", JOptionPane.YES_NO_OPTION) == JOptionPane.YES_OPTION) { book.deleteTransaction(selectedRow); loadDataToTable(); } } public static void main(String[] args) { SwingUtilities.invokeLater(() -> new MainFrame()); } }

逻辑说明：

• JTable使用DefaultTableModel动态管理数据，loadDataToTable()每次刷新都清空重载，避免状态不同步；
• 添加弹窗用JDialog模态对话框，阻塞主窗口操作，符合用户心智模型；
• LocalDate.now().format(...)生成默认日期，比new Date()更安全（无时区干扰）；
• 删除前JOptionPane.showConfirmDialog二次确认，这是UI交互的底线要求，漏掉会被用户骂死；
• SwingUtilities.invokeLater确保GUI在事件分发线程（EDT）中创建，避免多线程渲染异常。

3. 文件持久化避坑指南：那些让记账本“丢钱”的隐藏雷区

3.1 现象：程序重启后数据全没了 → 原因：文件路径没搞清，写到了错误目录 → 解决：用绝对路径+日志验证

新手常以为new FileWriter("data.txt")会把文件写到项目根目录，实际写入位置是JVM启动时的工作目录——可能是IDEA的bin目录、命令行执行时的/home/user，甚至某个临时路径。结果就是：你看到account_data.txt生成了，但下次运行时找不到它，因为工作目录变了。
解决：启动时打印绝对路径并记录日志：

System.out.println("数据文件路径：" + new File("account_data.txt").getAbsolutePath()); // 输出示例：/home/user/idea-project/account_data.txt

更稳妥的做法是显式指定路径：

private static final String DATA_FILE = System.getProperty("user.dir") + "/account_data.txt"; // 或用Class.getResource()获取jar同级路径（打包后也有效）

3.2 现象：中文备注显示为乱码（如“外卖”变“???”） → 原因：FileReader/FileWriter默认用系统编码，Windows是GBK，Linux/macOS是UTF-8 → 解决：强制指定UTF-8编码

FileReader和FileWriter不接受编码参数，必须升级为InputStreamReader/OutputStreamWriter：

// 错误写法（依赖系统默认编码） new FileReader("account_data.txt") // 正确写法（强制UTF-8） new InputStreamReader(new FileInputStream("account_data.txt"), StandardCharsets.UTF_8) // 对应写入 new OutputStreamWriter(new FileOutputStream("account_data.txt"), StandardCharsets.UTF_8)

提示：所有涉及文本IO的操作，只要含中文，必须显式指定StandardCharsets.UTF_8，这是Java IO的铁律。

3.3 现象：连续添加两笔相同金额的记录，表格里只显示一笔 → 原因：JTable的DefaultTableModel未触发视图刷新 → 解决：调用fireTableDataChanged()或重置模型

tableModel.setRowCount(0)后逐行addRow()是安全的，但若直接操作tableModel.getDataVector()再fireTableDataChanged()，易遗漏。最稳做法是每次操作后重建模型数据：

private void loadDataToTable() { // 方案1：清空+重加（当前代码已采用，可靠） tableModel.setRowCount(0); for (Transaction t : book.getAllTransactions()) { tableModel.addRow(new Object[]{...}); } // 方案2：替换整个数据向量（适合大数据量） // tableModel.setDataVector(dataVector, columnNames); }

3.4 现象：删除第3条记录后，原本第4条变成第3条，但用户仍选中旧索引导致删错 → 原因：JTable.getSelectedRow()返回的是视图行号，非数据模型行号 → 解决：用convertRowIndexToModel()

Swing表格支持排序/过滤，视图行号（view row）和模型行号（model row）可能不一致。正确删除姿势：

private void deleteSelectedRow() { int viewRow = table.getSelectedRow(); if (viewRow == -1) return; int modelRow = table.convertRowIndexToModel(viewRow); // 关键转换！ book.deleteTransaction(modelRow); loadDataToTable(); }

3.5 现象：金额输入10.555，保存后变成10.55或10.554999999999999→ 原因：double二进制浮点数精度丢失 → 解决：业务金额必须用BigDecimal

虽然教学版用double简化，但真实记账绝不允许精度误差。改造Transaction：

import java.math.BigDecimal; public class Transaction { private BigDecimal amount; // 替换double public Transaction(String date, String category, BigDecimal amount, String remark) { this.amount = amount.setScale(2, RoundingMode.HALF_UP); // 强制保留2位小数 } // getter返回BigDecimal，toString()用amount.toString()而非doubleValue() }

对应UI层输入校验：

try { BigDecimal amount = new BigDecimal(amountField.getText().trim()); // ... 创建Transaction } catch (NumberFormatException e) { JOptionPane.showMessageDialog(dialog, "金额格式错误，请输入数字（如：10.50）"); }

注意：BigDecimal构造函数绝不能传double（new BigDecimal(10.55)仍会继承double的精度缺陷），必须传String。

4. 从“能跑”到“能用”：三个让记账本真正落地的关键增强

4.1 金额精度加固：用BigDecimal替代double的完整改造清单

为什么必须这么做？
Java中0.1 + 0.2 != 0.3是经典陷阱。记账场景下，100.01 * 3算出300.03000000000003这种结果，用户会直接卸载应用。BigDecimal是唯一合规解，代价是代码稍冗长，但值得。

4.2 日期输入防错：用JFormattedTextField替代普通JTextField

手动输2024-05-32或2024/05/20会导致解析失败。用日期格式化器约束输入：

import javax.swing.text.DateFormatter; import java.text.SimpleDateFormat; // 在showAddDialog()中替换dateField： JFormattedTextField dateField = new JFormattedTextField( new DateFormatter(new SimpleDateFormat("yyyy-MM-dd")) ); dateField.setValue(new Date()); // 默认设为今天 dateField.setColumns(10);

优势：用户只能输入合法日期格式，非法输入（如2024-13-01）自动恢复为上次有效值，无需手动校验。

4.3 数据导出Excel：用Apache POI实现一键生成报表

用户常问：“能不能导出Excel？”——这是记账本进阶刚需。引入POI依赖（Maven）：

<dependency> <groupId>org.apache.poi</groupId> <artifactId>poi-ooxml</artifactId> <version>5.2.4</version> </dependency>

导出方法（加到AccountBook类）：

import org.apache.poi.ss.usermodel.*; import org.apache.poi.xssf.usermodel.XSSFWorkbook; public void exportToExcel(String filename) throws IOException { try (Workbook workbook = new XSSFWorkbook(); FileOutputStream fileOut = new FileOutputStream(filename)) { Sheet sheet = workbook.createSheet("记账明细"); // 表头 Row headerRow = sheet.createRow(0); String[] headers = {"日期", "类别", "金额", "备注"}; for (int i = 0; i < headers.length; i++) { Cell cell = headerRow.createCell(i); cell.setCellValue(headers[i]); } // 数据行 int rowNum = 1; for (Transaction t : transactions) { Row row = sheet.createRow(rowNum++); row.createCell(0).setCellValue(t.getDate()); row.createCell(1).setCellValue(t.getCategory()); row.createCell(2).setCellValue(t.getAmount().doubleValue()); // Excel只认double row.createCell(3).setCellValue(t.getRemark()); } // 自动列宽 for (int i = 0; i < headers.length; i++) { sheet.autoSizeColumn(i); } workbook.write(fileOut); } }

调用时机：在主界面加一个“导出Excel”按钮，点击后调用book.exportToExcel("account_export.xlsx")。注意setCellValue()对BigDecimal需转doubleValue()，Excel本身不支持高精度小数存储。

5. 验证你的记账本是否“真可用”：四步压力测试法

5.1 场景化测试清单：不靠代码覆盖率，靠真实操作流

别只测addTransaction()方法是否返回true，要模拟用户真实行为链：

执行建议：把这些场景写成.txt文档贴在项目根目录，每次重构后花5分钟手动跑一遍——比写JUnit单元测试更能暴露Swing线程问题。

5.2 文件损坏容灾：模拟断电后数据恢复能力

关机前强制杀掉Java进程（kill -9），再启动程序：

• ✅合格表现：程序能正常加载已有数据，新添加记录不丢失；
• ❌翻车表现：启动报NumberFormatException，或部分记录解析失败。

根因与修复：

• 问题：saveToFile()是覆盖写入，写到一半断电，文件被截断；
• 解决：改用“先写临时文件，再原子替换”：

public void saveToFile() { String tempFile = DATA_FILE + ".tmp"; try (PrintWriter writer = new PrintWriter( new OutputStreamWriter(new FileOutputStream(tempFile), StandardCharsets.UTF_8))) { for (Transaction t : transactions) { writer.println(String.format("%s|%s|%s|%s", t.getDate(), t.getCategory(), t.getAmount().toString(), t.getRemark())); } // 原子替换：Linux/macOS用Files.move，Windows需用File.renameTo Files.move(Paths.get(tempFile), Paths.get(DATA_FILE), StandardCopyOption.REPLACE_EXISTING); } catch (IOException e) { System.err.println("保存失败：" + e.getMessage()); } }

5.3 性能基线：1000条记录下的响应时间实测

用脚本批量生成1000条测试数据：

// 在main方法中临时添加 AccountBook testBook = new AccountBook(); for (int i = 0; i < 1000; i++) { testBook.addTransaction(new Transaction( "2024-01-" + String.format("%02d", (i % 28) + 1), Arrays.asList("餐饮", "交通", "购物", "娱乐").get(i % 4), new BigDecimal("10.00").add(new BigDecimal(i % 100)), "测试记录" + i )); }

实测指标（i5-8250U / 8GB内存）：

• 加载1000条：< 200ms（纯文本解析足够快）；
• 添加1条：< 50ms（含文件IO）；
• 删除1条：< 30ms；
• 导出Excel：< 1s（500条以内）。
  结论：纯Java Swing方案在千条数据内完全胜任，无需过早优化。

5.4 用户习惯适配：暗色模式与快捷键支持

程序员喜欢暗色主题，记账本也该跟上。Swing本身不支持系统级暗色，但可手动切换：

// 在MainFrame构造函数中添加 UIManager.setLookAndFeel(UIManager.getSystemLookAndFeelClassName()); // 或强制设为Nimbus（带现代感） // UIManager.setLookAndFeel("javax.swing.plaf.nimbus.NimbusLookAndFeel");

快捷键提升效率：

// 在initUI()中为按钮绑定快捷键 addButton.setMnemonic(KeyEvent.VK_A); // Alt+A deleteButton.setMnemonic(KeyEvent.VK_D); // Alt+D // 表格支持空格键快速删除（选中行后按空格） table.getInputMap(JComponent.WHEN_ANCESTOR_OF_FOCUSED_COMPONENT) .put(KeyStroke.getKeyStroke(KeyEvent.VK_SPACE, 0), "delete"); table.getActionMap().put("delete", new AbstractAction() { @Override public void actionPerformed(ActionEvent e) { deleteSelectedRow(); } });

我坚持给每个Java新手项目加这两项——不是为了炫技，而是让他们从第一天就建立“软件要适配人，不是让人适应软件”的产品意识。那个总在深夜调试IO编码问题的你，终有一天会感谢今天多写的这几行setMnemonic和UIManager。希望帮到你。

本文还有配套的精品资源，点击获取