硬核复式记账语言:Beancount(2023版)

「记账」始终是个人记录当中一个热门的话题。由于自己从事金融行业的缘故,对于这个话题也是格外关注。从最初用 Excel 记录,到后来使用各种主流的记账软件,我也经历了几轮流程的迭代和数据的「乾坤大挪移」。特别是去年开始,国内开发者的各种记账 app 层出不穷,基本上每周都能看到新的程序出现。对于我这种喜欢尝试新玩意儿的人来说,颇有些选择困难。但记账毕竟和其他的一般需求不同,它有着它的特殊性。可能是我个人比较挑剔,在使用了多个记账软件之后,我始终没有找到百分百合我心意的。其中几个常见的痛点包括:

  • 记账逻辑 :软件难以在便利性和多功能之间维持一个微妙的平衡,况且每个软件的逻辑都有细微的不同。例如,通过点击还是滑动触发记账,记账界面是否包括许多不需要的栏位,报销是否计入支出,修改余额是否会记录一笔分录等。
  • 迁移成本和稳定性 :这一点对于个人开发者尤为如此。目前各个程序之间的账务数据暂时还做不到完整迁移,一旦开发者暂停软件的支持,或者后台服务器停止运营,软件变成了离线模式,想转投其他软件也要大费周章

在零散地更换了几个记账软件之后,我决定静下心来,想想自己的需求,以及如何更好地、长期地实现。细想了一下自己在各个软件里的日常操作和背后的个人思维,我发现无论使用的是哪款软件,我脑内其实是用了 「复式记账」 的会计思维。对于不同的软件,我利用的是他们的账户特性、交易分类等功能来实现自己的脑内分录。那与其用多步转化,为何不直接用「复式记账」来进行?正在此时,我在网上遇到了 Beancount。

说实话,第一次见到 Beancount 我内心是拒绝的。纯文本环境,还要用 python 命令,修改参数等等。即使我学过些编程的皮毛,但骨子里的文科生本质还是对这么硬核的记账方式有些抵触的:这如何下手?在犹豫了一周之后,我鼓起勇气用一晚上时间完成了学习和初始化,两天后就决定全面搬迁到 Beancount。

它并没有看上去的那么硬核 。许多高级功能需要较为复杂的语法和命令,但掌握几条(甚至一条命令)在日常就能完成比软件更趁手的记账。您可以把这篇文章看作 Beancount 的入门懒人包,下文将展示 Beancount 与会计复式记账的异同、如何在半小时内入门,以及它为我解决了以前在 App 上没能解决的哪些日常功能。

什么是 Beancount 的复式记账?

复式记账的要义在于,每一笔交易可以表示为两个或以上账户、借贷方向相反、数额相同的两笔或多笔记录。用两句话总结也就是:

资产 (所有我有的)= 负债 (问别人借的)+ 所有者权益 (真的是我的)+( 收入支出

有借必有贷,借贷必相等。

例如,中午吃饭 40 元就可以表示成:

1
2
饮食-午餐  40
    信用卡 40

Beancount 采用的基本也是这个思路,但是略有不同。可能是为了淡化会计当中最复杂的借贷关系和账户属性,Beancount 的记录将每笔交易表示为两个或以上账户, 正负相反和为零 的记录。而且也不用表明借贷,不限顺序,比如:

1
2
Expenses:Lunch                          40.00 CNY
Liabilities:Card                     -40.00 CNY

只需用淳朴的感情记住各个种类的符号即可。

对于学过会计的同学而言,由于这个记账方法基于会计恒等式,但是又用正负号取代了借贷方向,因此就会出现一个在初期困扰了我很久的问题: 收入是负的 。也就是说,分录表示中收入必须要用负数表示,在报表中如果看到一段时间内的收入是负的,并不代表着入不敷出,而是恰恰相反。

为了避免这样的困惑,通常我会盯住实际的资金进出(资产、负债)。在输入资产减少(负数)之后,另一项自然便是正数,以此类推。这样可以减少费用和收入账户违背直觉的影响。

开始并呈现我的第一笔 Beancount 记账

如果有像我一样的编程苦手,使用 Beancount 也并不麻烦。以 Mac 为例,调出 Terminal,输入以下代码安装 Beancount 主程序,以及后台可视化程序 Fava:(用以前老师的话说:不理解没关系,记住就好)

1
2
sudo pip3 install beancount
sudo pip3 install fava

完成后我们就可以开始初始化了。由于这是文本记账,理论上来说任何文本编辑器都可以编写账本。然而,我强烈推荐安装微软的 VSCode,并且安装 Lencerf 编写的 Beancount 插件,可以让自己的生活方便许多。

之前我曾担心账户名称拼写错误导致代码报错,用了这个插件之后我发现我的担心都是多余的。该插件可以自动提示语法错误,对齐小数点,实时显示各个账户的余额。最重要的是,可以根据之前的账本提示账户名称和收款人名称。

工具到位了之后就可以开始建立账本了。新建一个文件,并存储为 main.bean(名字可以自定义),内容如下:

1
2
option "title" "MyBook" 
option "operating_currency" "CNY"

第一行用于设置账本的名字,而第二行用于设置账户的本位币。

由于前文提到的beancount的语法,部分账户的余额默认为负数,在编制报表的时候呈现的数字会和一般会计意义上的数字有出入(权益、收入为负,实则为正……)。幸运的是,程序为我们提供了选项来解决这个问题,我们可以在文件开始继续加入:

1
2023-07-22 custom "fava-option" "invert-income-liabilities-equity" "true"

稍后我们看到的报告程序中,option 选项卡中有不少可以调整的选项,也可以根据它们所在的分类,通过以上两种方式进行调整。

下一步就是要设立账户。在其他记账软件中,普遍都会根据开发者的默认设置给用户提供一套「常用账户」,但很多科目对我来说其实并不常用,反而需要繁琐地一个个修改名称、图标。对于 Beancount 而言,一切就是一张白纸,只需要通过一行代码开启账户即可。账户支持分组和多层分类,以冒号分割。例如:

1
2
3
4
5
1990-01-01 open Assets:Cash:ICBC CNY
1990-01-01 open Liabilities:Card:BOCOM CNY, USD
1990-01-01 open Equity:OpenBalance CNY, HKD, USD
1990-01-01 open Income:Salary CNY
1990-01-01 open Expenses:Meal:Lunch CNY

这当中,除了最开始的账户分类(Assets, Liabilities, Equity, Income, Expenses)不可修改外,其他的均可按照个人实际需求进行设置。

在设置账户的过程中是否越细越好?其实不然。过于精细的设置会产生更大的摩擦,导致记账过程无法持续。例如,我曾经在另一些软件中将自己定投的每个基金分门别类通过软件的功能进行登记。虽然可以帮助我及时刷新最新的净值,mark to market,但是每次登记新买入的定投份额着实不是一件让人愉悦的工作。因此,这种摩擦让我很快产生了怀疑:我真的需要这么细节的报告吗?如果我想知道净值,我可以花五秒钟去看一下基金 app,而我现在需要花两分钟在不同 app 之间切换更新净值……因此最后我就把基金打包成一个账户,每个月底更新净值(下文会介绍到更新的方法)。当然,如果设置账户过于笼统,则会损失报告的颗粒度。所以说,账户的设置在你会计学中是一个学问呢。

完成后,在终端通过 cd 命令进入到记账文件的文件夹,输入:

1
fava main.bean

顺利的话,终端就会提示:Running Fava on http://localhost:5000

此时打开浏览器登录这一网址,就能够看到一排账户已经虚位以待了。随后,继续回到 VSCode,就可以在插件的配合下开始第一批分录——余额初始化。由于这笔分录的格式和日常记账并无区别,新手可以通过这一过程熟悉语法结构。常见的一笔分录至少分为三行,比如:

1
2
3
2021-06-01 * "" ""
    Assets:Cash:ICBC            378.32 CNY
    Equity:OpenBalance
  • 第一行表示记账的日期,后面两个引号内分别表示商户/收款人名称,以及备注。如果没有的话建议还是留出这个位置。注意,必须使用英文引号。
  • 后面的两行或多行就是涉及的账户及金额。在初始化的过程中,我们一般借用 Equity 账户进行操作。因此,在初始化的时候,记得建立一个 Equity 账户,作为初始资金。

您可能也注意到了,最后一行并没有写数字。这正是 Beancount 语法中偷懒的方法之一:如果只空缺了一个金额,系统会自动计算差额,实现正负平衡。这不仅减少了我的工作量,更避免了账不平的情况。

在对所有账户进行完初始化操作后,保存并刷新网页,界面上已经可以显示出当下的个人资金状况了。从今天起,Beancount 就可以正式用于记账了。

用 Beancount 优化日常记账场景

光从输入的层面上来说,Beancount 一定不是最简洁的。从界面上来说,它也一定不是最美观的。但它「硬核而原始」的记账方式,却轻松解决了我在其他软件上遇到的一些痛点。

与同事午饭 AA

工作日中午经常和同事一起吃饭。吃完饭之后的一项「重要金融工程」,便是结账以及转账——通常一个人负责结账,剩下的同事们 AA 制用支付宝或者微信进行转账。现实中简单的操作在记账过程中却犯了难——多笔交易、多个账户,还需要对金额进行加减乘除的运算。和身边记账的同事讨论之后,我发现了几个常用做法(以 4 个人午餐,我用信用卡支付了 200,每人给了我 50 为例):

第一种 :记录支出 200,再记录收入 150。这样子的好处在于仅涉及到支出和收入两个交易类型,即使是最简单的记账软件也可以实现。但问题就是:这样的记录会导致支出和收入脱离实际。或许 200 元还体现不出,但如果这是个部门聚餐,10 个人一共花了 2000 元呢?其实我自己在饮食上只花费了 200,而收入的 1800 也只是我收回了我的应收账款。在损益表分析的时候容易造成误差。

第二种 :记录支出 50,再记录一笔(或多笔)从信用卡到微信/支付宝等收款账户的转账。这样的做法消除了上一种记录方式中对分类收支的影响。但从流程上而言过于麻烦,如果涉及到多个收款账户,那就更为复杂了。我尝试了多款记账 app,均不能完美解决这一刚需。基本都需要在几个功能之间来回跳转,各个 app 的逻辑也各有不同。

而在 Beancount 里边,此类复杂记账就变得很简单了。从结构上来说,与自己一个人吃饭并没有什么不同:

1
2
3
4
5
2021-06-01 * "XYZ" ""
    Liabilities:Card -200.00 CNY
    Assets:Alipay 50.00 CNY
    Assets:Wechat 100.00 CNY
    Expenses:Meal:Lunch

在一笔记录中就可以一气呵成。如果无法理解语句的意义,不如将它一行行转化为故事:「6 月 1 日我在XYZ花了一笔钱:我用信用卡支付了 200 元;同事用支付宝给了我 50;用微信又给了我 100;剩下的就是我自己吃的,算作我的午饭开销。」是不是直观又简单?

快捷记录这个月基金的收益

记账的过程中另一个曾经困扰我的点在于我究竟需要统计多少细节:数据太少会影响到报告的质量,而数据太多则会占据我大量的时间和精力用以输入与更新。就拿基金举例,不少软件(例如 MoneyWiz)的投资账户功能非常强大,但是逻辑复杂,需要登记每个基金的成本,以及每天的净值。但对于我而言,这些已经超出了我的需求范围,更多的记账语句徒增烦恼尔。因为我主要做被动的长期投资,我并没有需要了解每个基金每天的走势情况,只需要在每个月月底做一个盘点,了解本月盈利或是亏损了多少,并反映在个人整体财务状况中即可。

不少软件把基金收益和亏损分别放在「支出」和「收入」下的两个账户,也不支持负数输入,导致两个科目下都有数值,无法准确地显示基金总体的净盈亏状况。在 Beancount 中,由于一切都是高度定制化的,我只需在收入项下建立一个基金收益的科目,其余额为负数即为收益,正数即为亏损。(会计中一些账户根据期末余额出现在「借方」还是「贷方」,会有不同表述)

此外,之前使用过的不少软件中,更新月底的数据并不是一件容易的事情。如果我使用修改余额功能更新账户数据,这部分差额并不会计入损益表,而只是作为一个系统调整。因此,无法正确、直接地统计投资的损益情况。

使用 Beancount 后,运用 pad 和 balance 命令,我只需告诉系统月底的实际余额为多少,系统就会将差额计入规定的账户,并体现在损益表上。例如:

1
2
2021-05-31 pad Assets:Investment Income:InvestmentGain
2021-06-01 balance Assets:Investment 33597.19 CNY

转化成自然语言也非常好理解:「5 月 31 日,投资账户的差额计入投资收益里面;6 月 1 日,投资账户实际有 33597.19 元,系统你操作一下吧。」短短两条命令,免除了我拿着手机在各个 app 之间切换的困扰,我也不再需要按着计算器计算差额。

由于在每个月底这套流程是不变的,我也大可以从之前的文件中复制黏贴,仅需更改数字即可。很难说手机上的「直观操作」和这份「硬核代码」相比,哪个效率更高。

结语

其实 Beancount 的功能远远不止这些。多币种记账,通过脚本自动导入账单、更新基金净值等功能自然不在话下。甚至还有高手将它变成了事件记录簿和家里的库存管理软件。然而对于我来说,以上的功能足以满足我对于日常记账,以及记账软件的需求了。每天晚上回到家里,打开 VSCode,我就可以像写日记一样,用几分钟时间完成当天的记账。

正如文章一开始所说的,适合一个人的记账软件与方法可能对另一个人并不有效。只有适合自己的,才是最好的。

唯一希望可以提高的一点就是,这个程序现在大多部署在本地,没有很好的移动端解决方案。我也正在不断探索,如果有更好的方案,可能会写在 2024 版中吧(笑)。

使用 Hugo 构建
主题 StackJimmy 设计