记账工具核心实体为Account、Transaction、Category三类；Transaction金额必须用BigDecimal并禁用基本运算符；持久化推荐Jackson序列化RecordBook至JSON；交互采用编号菜单与输入校验；务必重写toString()和equals()。
如何用 Java 类建模记账核心实体
记账工具本质是“钱的流动记录”，不是功能堆砌。先想清楚三个关键对象：Account（账户，如现金、微信、银行卡）、Transaction（交易，含金额、类型、时间、备注）、Category（分类，如餐饮、交通、工资）。别一上来就写界面或文件读写——类设计错了，后面全是补丁。
重点注意：Transaction 的 amount 必须用 BigDecimal，不用 double 或 float。否则 0.1 + 0.2 != 0.3 是铁定发生的，记账数字出错就是硬伤。
-
Account至少包含id、name、balance（BigDecimal）字段，构造时balance初始化为BigDecimal.ZERO -
Transaction的type建议用枚举：enum Type { INCOME, EXPENSE }，避免字符串拼写错误 - 所有金额相关 setter 方法里，必须做
null检查和正负校验（比如支出不能传正数）
如何持久化数据而不依赖数据库
简易工具不需要 MySQL 或 H2。用 Java 自带的 java.util.prefs.Preferences 或序列化到 JSON 文件更轻量。但 Preferences 有平台限制（Windows 注册表 / macOS plist），跨平台首选 JSON。
推荐用 com.fasterxml.jackson.databind.ObjectMapper（Jackson）写入/读取，不要手写字符串拼接。它能自动处理 BigDecimal、LocalDateTime 等类型，避免格式错乱。
立即学习“Java免费学习笔记（深入）”；
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 把
List<Transaction>包进一个容器类（如RecordBook），再整体序列化，别单条存——否则增删改查时文件 IO 太频繁 - 写入前先写到临时文件（如
data.json.tmp），成功后再renameTo覆盖原文件，防止程序崩溃导致数据清空 - 读取失败时（如 JSON 格式损坏），不要直接抛异常退出，应返回空列表并打印警告日志，保证程序还能启动
ObjectMapper mapper = new ObjectMapper();
mapper.registerModule(new JavaTimeModule()); // 支持 LocalDateTime
RecordBook book = mapper.readValue(new File("data.json"), RecordBook.class);
如何让控制台交互不变成“输入地狱”
用户不想记命令语法。用编号菜单 + 简单输入，比自由输入更可靠。关键不是炫技，是降低误操作率。
比如添加支出，流程应该是：显示分类列表 → 用户输编号 → 输入金额 → 输入备注 → 回车确认。而不是让用户自己敲 “EXPENSE 餐饮 45.5 午餐”。后者容易输错空格、漏字段、金额格式错。
- 所有用户输入后，立即用
trim()去首尾空格，再判空；空输入直接提示重输，不往下走 - 金额输入必须用
new BigDecimal(inputStr)尝试解析，捕获NumberFormatException并提示“请输入有效数字” - 日期若允许用户省略，默认用
LocalDateTime.now()，别强制填年月日时分秒
为什么 toString() 和 equals() 不是可选项
调试时你肯定要 System.out.println(transaction)；查重、去重、查找时必然用到 equals()。不重写它们，打印出来就是 Transaction@1a2b3c4d，查重永远返回 false。
IDE 自动生成即可，但要注意：如果用了 BigDecimal 字段，equals() 里不能用 ==，必须用 compareTo() == 0；toString() 中建议用 toPlainString() 避免科学计数法（如 1E+5）。
- IntelliJ 快捷键：Alt+Insert → “Generate” → 勾选
toString()、equals()、hashCode() - 生成后手动检查
BigDecimal字段是否用了Objects.equals(a, b)（它内部会调用compareTo） - 测试一下：
new Transaction(..., new BigDecimal("10.00")).equals(new Transaction(..., new BigDecimal("10")))必须返回true
最易被忽略的点：所有金额运算必须用 add()、subtract()、multiply() 方法，绝不用 +、-、* 运算符。哪怕只做一次加减，漏了也会在某次导出报表时发现余额对不上——而那时可能已经记了上百笔账。
