代码开源:Python+Beancount 实现自动记账,告别繁琐的对账

转载请注明出处❤️

作者:测试蔡坨坨

原文链接:caituotuo.top/e23370ad.html


写在前面

你好,我是测试蔡坨坨。

去年年初分享了关于「复式记账」以及「如何使用Python+Beancount实现自动记账」,时光荏苒,转眼间来到了2025年。在过去的一年时间里,我也一直坚持使用Beancount进行复式记账,同时也对最初的那个问题“一年之余,财富何方?”有了更清晰的认识。

辛苦一年赚来的钱,流向何处,如何分配,很大程度上反映了你最真实的情绪和欲望,也代表着我们想成为怎样的人。

在「复式记账」系列更新完结后,不少小伙伴向我咨询源代码的问题,为回馈大家的支持,也希望更多人轻松上手复式记账,现将代码开源并附上使用说明,一起踏上高效理财的新征程,一起探索记账的更多可能性。

系列回顾

在此之前,让我们先来回顾一下「复式记账」系列所涵盖的内容,同时也是使用自动记账工具的前提。

复式记账系列共有四篇文章:

  1. 一年之余,财富何方?

    回答了 “为什么要记账?” && “如何保持记账的动力?”

  2. 财富梳理:复式记账之道

    了解了 “什么是复式记账?” && “复式记账的优势?”

  3. 财富编织:Beancount 复式记账指南

    学习了 “如何使用beancount工具实现复式记账?”

  4. 自动记账:Python+Beancount

    当我们完成了 1~3 步骤,其实也就搭建了一个完整的复式记账工作流程。

    然而,当我们尝试使用 Beancount 手动记账一段时间后,虽然感受到了复式记账带来的财务清晰感,但手动记账的过程未免显得过于单调乏味,很容易让人逐渐失去动力。

    于是,为了让记账这件事变得高效且能够长期坚持,自动记账的想法应运而生。

操作指南

源码获取方式:关注公众号「测试蔡坨坨」,回复关键词 记账 领取。

使用说明(详细参考「自动记账:Python+Beancount」):

  1. 下载账单并解压

    下载 微信支付宝 的账单文件,并将其解压到 data/bank_statements 目录中(每次仅支持处理一份微信账单和一份支付宝账单文件)。

  2. 配置账户映射

    打开 constants/enums.py 文件,设置 AccountEnum 枚举,以确保账单中的账户与 beancount 配置中的账户相对应。

  3. 自定义账单解析规则

    在 src/accounting/rules.py 文件中,根据需要调整账单解析规则。

  4. 生成 beancount 格式账单

    运行 main.py,生成的 beancount 格式账单文件将保存到 data/processed 目录中。

效果展示

详情参考「财富编织:Beancount 复式记账指南」&&「自动记账:Python+Beancount