skip to content
AsyncX's Blog

第一期-Beancount使用体验

/ 6 min read

前言

为了督促自己自律一点,持续更新博客,我打算将应用软件类的使用心得教程类作为一个栏目写。一是这样方便大家对工具类的博客进行索引,二也可以对大家的软件的选择起到引导性作用。 言归正传,官网是这么描述Beancount的。Double-Entry Accounting from Text Files.即为从文本调用的复式簿记

什么是复式簿记?

复式簿记是一种把每笔交易都记录到复数个账户中的簿记方法,简单来说就是“有得必有失”。

当你从你的B账户为A支付了$x$元,那么你的账户就损失了$x$元,损失的这份价钱转变为了A的价值,而单独对于你的B账户,作为支付方损失了A的价值。但此时对你来说你所具有的财富仍然保持不变,这个例子使用Beancount的记录如下:

2023-05-01 * "买了A"
  Assets:Cash                            -X CNY
  Expenses:Shopping                      +X CNY

这样记账的好处是什么?

由于复式簿记的前提是收支守恒,那么遇到以下例子也会很方便记账: 你和甲,乙三个人去吃饭,总共花了$3X$元,甲帮你垫付了$\frac{1}{2}$的钱,乙也帮你垫付了$\frac{1}{2}$的钱,你需要分别还给他们,这时使用Beancount的记录如下:

2023-05-01 * "和甲乙吃饭"
  Assets:Cash                            -X CNY
  Liabilities:Jia                      +X/2 CNY
  Liabilities:Yi                       +X/2 CNY

这个例子中的收支依旧为0,区别和上面的则在于支出项为两个人(复数个),在遇到此类情况,复式簿记的优势就体现出来了。

如何使用Beancount来进行记账

安装

Beancount可以用以下方法安装,并同时安装fava-Beancount的实用性UI。

python -m venv BEANCOUNT
source BEANCOUNT/bin/active
pip install beancount
pip install fava

结构

记账作为一个持久性的项目,需要具备如下特点:

  • 准确性
  • 持久性 而Beancount作为记账软件可以额外提供的:
  • 永久性
  • 安全性 我从这里开始将用最快可投入使用的语言进行描述。 首先的首先,你需要创建一个main.bean来令fava进行读取操作,这个bean文件更类似于索引功能。
;账本信息
option "title" "main" ;账本名
option "operating_currency" "CNY" ;账本货币
2001-08-06 custom "fava-option" "language" "zh"
include "accounts/assets.bean" ;资产账户设置及初始化
include "accounts/liabilities.bean" ;负债账户设置及初始化
include "accounts/expenses.bean" ;支出账户设置
include "accounts/income.bean" ;收入账户设置


;交易记录
include "2023/2023.bean" ;2023账本

其次,你需要创建用于支付的项目和用于支付的账户。

account/assets.bean
2001-08-06 open Equity:OpenBalance ;用于账户初始化,支持任意货币
2001-08-06 open Assets:Card:9806 CNY ;尾号9806的银行卡
2001-08-06 open Assets:Card:2437 CNY ;大学银行卡
2001-08-06 open Assets:Alipay:Name CNY ;支付宝
2001-08-06 open Assets:Wechat:Name CNY ;微信

需要强调的地方:账户的名字必须大写,你需要为所有的账户制定货币单位(CNY)。 此外,还需要创建付款项,这里我参考了其他记账软件的项目:

account/expenses.bean
2001-08-06 open Expenses:Other CNY
2001-08-06 open Expenses:Dining CNY
2001-08-06 open Expenses:Shopping CNY
2001-08-06 open Expenses:Transportation CNY
2001-08-06 open Expenses:Entertainment CNY
2001-08-06 open Expenses:Electronics CNY
2001-08-06 open Expenses:Clothing CNY
2001-08-06 open Expenses:Pets CNY
2001-08-06 open Expenses:Daily CNY
2001-08-06 open Expenses:SnacksandBeverages CNY
2001-08-06 open Expenses:FruitsandVegetables CNY

你还需要按照以上格式创建负债账户和收入账户,前缀分别为Liabilities:XXIncome:XX,这些均放置于main.bean同目录的account文件夹内。

最后,创建账本。我是按照年/月来进行账本的分类,每月进行汇总。你无需自己创建,我将模板放在本文最后。

使用

安装完成且正常创建后,在main.bean同目录下输出fava main.bean --port 8888打开服务,main.bean为账本项目,--port 8888为在端口8888打开网页,指定端口防止了Mac电脑默认端口的冲突。打开localhost:8888,你可以看到直观的数据。

到这一步,就已经完成安装了。

工作流

Notion 月账单模板

通过两个select记录资金的出和入,每月导出一次到 beancount 进行统计。

如果有可以解决通过 Notion 多对一 /多对多记账的更好方案和脚本欢迎 pr 。

脚本和年度账本模板:A5yncX/notion-to-beancount