第一期-Beancount使用体验

,

前言

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

什么是复式簿记？

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

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

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

这样记账的好处是什么？

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

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

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

如何使用Beancount来进行记账

  • Beancount Documentation
  • Beancount - Language Syntax

    安装

    Beancount可以用以下方法安装，并同时安装fava-Beancount的实用性UI。
    1
    2
    3
    4
    python -m venv BEANCOUNT
    source BEANCOUNT/bin/active
    pip install beancount
    pip install fava

    结构

    记账作为一个持久性的项目，需要具备如下特点：
  • 准确性
  • 持久性
    而Beancount作为记账软件可以额外提供的：
  • 永久性
  • 安全性
    我从这里开始将用最快可投入使用的语言进行描述。
    首先的首先，你需要创建一个main.bean来令fava进行读取操作，这个bean文件更类似于索引功能。
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    ;账本信息
    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账本
    其次，你需要创建用于支付的项目和用于支付的账户。
    1
    2
    3
    4
    5
    6
    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）。
    此外，还需要创建付款项，这里我参考了其他记账软件的项目：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    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:XX和Income: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