关键词:记账工具、收支记账、本地存储、月度统计、CSV 导出、前端工具
一、背景与需求
日常生活中,记账是理财的第一步。但很多记账 App 功能臃肿,需要注册登录、数据上云,部分核心功能还收费。对于只需要“快速记一笔、看看本月结余、偶尔导出备份”的用户来说,过于复杂的工具反而增加了记账门槛。
现有的轻量记账工具多为原生 App,安装后占用存储空间,且数据难以自主备份。缺乏一款免费、无需登录、数据本地存储、支持自然语言快速输入、支持 CSV 导出的网页端记账工具。
基于此,我开发了 Toolion 记账(轻量版)(项目地址:toolion.cn/bookkeeping…
二、核心功能
| 功能 | 说明 |
|---|---|
| 自然语言快速记账 | 支持「备注 + 金额」格式输入,如:午饭 35、打车 28.5、工资 10000 |
| 收支分类 | 收入 / 支出一键切换,颜色区分(支出红、收入绿) |
| 今日支出与本月结余 | 实时统计今日支出金额与本月收支结余 |
| 流水记录列表 | 按天分组展示收支明细,支持“今天”“昨天”“X 月 X 日”友好日期显示 |
| 单条删除 | 支持删除任意一条记录 |
| CSV 导出 | 一键导出全部流水为 CSV 文件,带 BOM 头确保 Excel 打开不乱码 |
| 数据本地存储 | 所有数据保存在浏览器 localStorage 中,无需上传,无需登录 |
| 亮色/暗色主题 | 支持系统主题跟随与手动切换 |
| 纯前端运行 | 所有计算与存储在浏览器本地完成,离线即可使用 |
三、技术实现
3.1 整体架构
记账(轻量版)是一个纯前端的单 HTML 页面应用,不依赖任何后端服务,所有逻辑(输入解析、数据存储、统计计算、列表渲染、CSV 导出)均运行在浏览器中:
浏览器端(纯原生 JavaScript)
├── 输入层:自然语言输入框、收支类型切换、提交按钮
├── 存储层:localStorage 持久化(STORAGE_KEY: minimal-bookkeeping)
├── 计算层:今日支出、本月收支结余、按天分组统计
└── 渲染层:统计卡片、按天分组的流水列表、CSV 导出、Toast 提示
3.2 自然语言输入解析
工具支持用户用最自然的方式输入记账内容,无需分多个字段填写。核心解析逻辑如下:
function parseInput(str) {
str = str.trim();
if (!str) return null;
// 匹配末尾的数字(支持小数)
const match = str.match(/^(.*?)(\d+(?:\.\d{1,2})?)$/);
if (match) {
const note = match[1].trim() || '未命名';
const amount = parseFloat(match[2]);
if (amount > 0) {
return { note, amount };
}
}
return null;
}
支持的输入示例:
午饭 35→ 备注:午饭,金额:35打车 28.5→ 备注:打车,金额:28.5工资 10000→ 备注:工资,金额:10000未命名 0→ 无效,金额需大于 0
解析时取字符串末尾的数字作为金额,其余部分作为备注。若未填写备注,默认显示为“未命名”。
3.3 数据本地存储
所有记账数据保存在浏览器的 localStorage 中,键名为 minimal-bookkeeping。数据以 JSON 数组形式存储,每条记录包含:
{
id: Date.now().toString(), // 唯一标识
type: 'expense' | 'income', // 支出 / 收入
note: '午饭', // 备注
amount: 35, // 金额
date: '2026-11-05T14:30:00.000Z' // 记录时间(ISO 字符串)
}
读取时自动按时间倒序排列,确保最新记录显示在前面。
注意:数据仅保存在浏览器本地,清除浏览器缓存或使用无痕模式可能导致数据丢失。建议定期使用「导出 CSV」功能备份。
3.4 统计计算
工具实时计算两个核心指标:
- 今日支出:今日(按日期字符串匹配)所有支出记录的金额总和
- 本月结余:本月所有收入记录总和 − 本月所有支出记录总和
const now = new Date();
const todayStr = now.toISOString().split('T')[0]; // YYYY-MM-DD
const monthStr = todayStr.substring(0, 7); // YYYY-MM
records.forEach(r => {
const rDate = r.date.split('T')[0];
if (rDate === todayStr && r.type === 'expense') {
todayExpense += r.amount;
}
if (rDate.startsWith(monthStr)) {
if (r.type === 'income') monthIncome += r.amount;
else monthExpense += r.amount;
}
});
const balance = monthIncome - monthExpense;
本月结余为正时显示绿色(收入色),为负时显示红色(支出色),为零时显示中性色。
3.5 按天分组渲染
流水列表按日期分组展示,每组显示日期标题(今天 / 昨天 / X 月 X 日)与当日收支小计,下方列出当日每条记录的时间、备注、金额与删除按钮。
日期标题逻辑:
- 若是当天:显示“今天”
- 若是昨天:显示“昨天”
- 否则:显示“X 月 X 日”
3.6 CSV 导出
点击「导出 CSV」按钮,将全部记录按时间正序导出为 CSV 文件,文件名为 记账流水_YYYY-MM-DD.csv。
CSV 格式包含表头:日期,类型,备注,金额。为确保在 Excel 中打开不乱码,文件内容前加了 UTF-8 BOM 头(\uFEFF),备注中包含双引号时会进行转义。
let csvContent = '\uFEFF日期,类型,备注,金额\n';
sorted.forEach(r => {
const dateStr = new Date(r.date).toLocaleString('zh-CN', { hour12: false });
const typeStr = r.type === 'expense' ? '支出' : '收入';
const noteStr = `"${r.note.replace(/"/g, '""')}"`;
csvContent += `${dateStr},${typeStr},${noteStr},${r.amount.toFixed(2)}\n`;
});
四、关键技术挑战与解决方案
| 挑战 | 解决方案 |
|---|---|
| 自然语言输入解析 | 使用正则表达式匹配字符串末尾的数字作为金额,其余作为备注 |
| 数据本地持久化 | 使用 localStorage 存储 JSON 数组,读取后按时间倒序排列 |
| 按天分组展示 | 按日期字符串分组,按日期倒序排列,日期标题智能显示“今天/昨天/X 月 X 日” |
| CSV 导出乱码问题 | 在 CSV 内容前加 UTF-8 BOM 头,备注中的双引号进行转义 |
| 输入实时响应 | 输入框回车提交,所有操作后自动重新渲染统计与列表 |
| 纯前端无后端依赖 | 所有计算与存储逻辑封装在单个 HTML 文件中,浏览器即可离线运行 |
五、使用示例
示例:记录一笔午餐支出
- 打开工具,默认处于“支出”模式;
- 在输入框填写
午饭 35; - 点击「记一笔」或按回车键;
- 系统显示 Toast 提示“已记支出 ¥35.00”;
- 统计卡片更新:今日支出 ¥35.00;
- 流水列表新增一条:今天 · 午饭 · - ¥35.00。
示例:记录一笔工资收入并导出备份
- 切换到“收入”模式;
- 输入
工资 10000,提交; - 统计卡片更新:本月结余 ¥9965.00(假设今日支出 35);
- 点击「导出 CSV」,浏览器下载
记账流水_2026-11-05.csv; - 打开 CSV,可看到完整的日期、类型、备注、金额表格。
六、隐私与免责声明
工具完全在前端运行,所有记账数据保存在浏览器的 localStorage 中,不会上传至任何服务器,也不进行任何形式的存储与追踪。
免责声明:本工具数据仅存储在您的浏览器本地(localStorage)中,不会上传至任何服务器。清除浏览器缓存或使用无痕模式可能导致数据丢失,建议定期导出 CSV 备份。本工具仅提供简单的收支记录功能,不构成理财建议。
七、总结
Toolion 记账(轻量版)通过纯前端原生 JavaScript 实现了极简的收支记账功能。核心设计思路:
- 自然语言输入:「备注 + 金额」一步完成记账,无需分多个字段填写;
- 本地存储:数据保存在浏览器 localStorage,免登录、免费、隐私安全;
- 实时统计:今日支出与本月结余自动更新,收支一目了然;
- 按天分组:流水记录按天聚合,支持“今天/昨天/X 月 X 日”友好显示;
- CSV 导出:一键导出全部流水,支持 Excel 打开,方便数据备份与迁移;
- 零后端依赖:全部计算与存储在浏览器本地完成,离线即可运行。