纯前端实现的轻量级记账工具:收支记账、月度统计与 CSV 导出

0 阅读5分钟

关键词:记账工具、收支记账、本地存储、月度统计、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 文件中,浏览器即可离线运行

五、使用示例

示例:记录一笔午餐支出

  1. 打开工具,默认处于“支出”模式;
  2. 在输入框填写 午饭 35;
  3. 点击「记一笔」或按回车键;
  4. 系统显示 Toast 提示“已记支出 ¥35.00”;
  5. 统计卡片更新:今日支出 ¥35.00;
  6. 流水列表新增一条:今天 · 午饭 · - ¥35.00。

示例:记录一笔工资收入并导出备份

  1. 切换到“收入”模式;
  2. 输入 工资 10000,提交;
  3. 统计卡片更新:本月结余 ¥9965.00(假设今日支出 35);
  4. 点击「导出 CSV」,浏览器下载 记账流水_2026-11-05.csv;
  5. 打开 CSV,可看到完整的日期、类型、备注、金额表格。

六、隐私与免责声明

工具完全在前端运行,所有记账数据保存在浏览器的 localStorage 中,不会上传至任何服务器,也不进行任何形式的存储与追踪。

免责声明:本工具数据仅存储在您的浏览器本地(localStorage)中,不会上传至任何服务器。清除浏览器缓存或使用无痕模式可能导致数据丢失,建议定期导出 CSV 备份。本工具仅提供简单的收支记录功能,不构成理财建议。


七、总结

Toolion 记账(轻量版)通过纯前端原生 JavaScript 实现了极简的收支记账功能。核心设计思路:

  1. 自然语言输入:「备注 + 金额」一步完成记账,无需分多个字段填写;
  2. 本地存储:数据保存在浏览器 localStorage,免登录、免费、隐私安全;
  3. 实时统计:今日支出与本月结余自动更新,收支一目了然;
  4. 按天分组:流水记录按天聚合,支持“今天/昨天/X 月 X 日”友好显示;
  5. CSV 导出:一键导出全部流水,支持 Excel 打开,方便数据备份与迁移;
  6. 零后端依赖:全部计算与存储在浏览器本地完成,离线即可运行。