记账神器beancount
记了几年账,工具用过随手记、Excel甚至Evernote。通常只记收支,不记收支对应的账户变化。其实知道这种方式很粗浅,容易错记、漏记,并且只能分析收支,无法跟踪个人财务现状。结果则是,虽然记了几年,却很少分析,个人财务状态也没有实质改善。
几个月前看到byvoid分享Beancount,发现是一款记账神器。我从7月1日正式使用,如今也有3个多月,分享一些经验心得。
一、普通记账 vs 复式记账
Beancount记账方法叫复式记账。
把只记录收支的方法称为普通记账(估计是多数人在用的方法)。那么复式记账,除了记录收支,还需记录账户(支付宝、银行卡等)的变动。以一个最简单的例子感受二者的区别:
假设:7月1日,打车花费30元,使用银行卡支付。
普通记账一般包括日期、收支分类和金额,如下:
2019-08-28: 交通-打车 -200元
复式记账把账户变化也一并记账,如下:
2019-08-28:
交通-打车 200元
银行卡 -200元
复式记账会记录每笔交易的资金流动,各账户变化「有正有负,正负相等」。这便是复式记账的基本原理,称之为「会计恒等式」。这种方式能够保证记账准确无误,也能提供更详细的财务分析。
这句话中的账户是广义的,也可理解为分类,「银行卡」和「交通-打车」都是账户。下文中出现账户,若无特别说明,均指广义的账户。
二、Beancount入门
复式记账是方法论,而Beancount则是支持复式记账的工具,Beancount有以下三个优点:
- 完整个人财务数据比较敏感,Beancount本地存储,不用担心数据泄露。
- 纯文本账本,不依赖特定软件,便于数据迁移。
- Beancount是开源软件。
接下来介绍Beancount的基础使用。
安装
beancount是个Python项目,安装好python后,执行:
pip install beancount
pip install fava
Fava是关联软件,为Beancount提供一个更漂亮的Web界面(如图1/2/3),建议同时安装。
账本示例
Beancount的使用非常简单,概括为两步:
第一步:使用文本文件按一定格式记账。
下面是个完整示例,直接保存为moneybook.bean
(Beancount的文件扩展名为.bean
)
;【一、账本信息】
option "title" "我的账本" ;账本名称
option "operating_currency" "CNY" ;账本主货币
;【二、账户设置】
;1、开设账户
1990-01-01 open Assets:Card:1234 CNY, USD ;尾号1234的银行卡,支持CNY和USD
1990-01-01 open Liabilities:CreditCard:5678 CNY, USD ;双币信用卡
1990-01-01 open Income:Salary CNY ;工资收入
1990-01-01 open Expenses:Tax CNY ;交税
1990-01-01 open Expenses:Traffic:Taxi CNY ;打车消费,只支持CNY
1990-01-01 open Equity:OpenBalance ;用于账户初始化,支持任意货币
;2、账户初始化
2019-08-27 * "" "银行卡,初始余额10000元"
Assets:Card:1234 10000.00 CNY
Equity:OpenBalance -10000.00 CNY
;【三、交易记录】
2019-08-28 * "杭州出租车公司" "打车到公司,银行卡支付"
Expenses:Traffic:Taxi 200.00 CNY
Assets:Card:1234 -200.00 CNY
2019-08-29 * "" "餐饮"
Assets:Card:1234 -1100.00 CNY
Liabilities:CreditCard:5678 1100.00 CNY
2019-08-31 * "XX公司" "工资收入"
Assets:Card:1234 12000.00 CNY
Expenses:Tax 1000.00 CNY
Income:Salary
第二步:命令行执行fava moneybook.bean
,看到如下结果:
$ fava moneybook.bean
Running Fava on http://localhost:5000
再到浏览器中打开http://localhost:5000
就能看到账本,下图分别是损益表、资产负债表、日记账的截图。其它栏目自行探索。
记账格式
使用Beancount,关键就是了解它的记账格式。从示例可知,账本包括三个部分:
- 账本信息:比如账本名称,账本主货币。
- 账户设置:包括开设账户和账户初始化。
- 交易记录:日常记账。
下面依次介绍。
账本信息
一般设置账本的名称和主货币即可。
option "title" "我的账本" ;账本名称
option "operating_currency" "CNY" ;账本主货币
账户设置
【开户】
记账之前,得有账户,开户格式如下:
开启日期 open 账户名 货币类型
Beancount中账户名支持层级,以英文冒号:
分隔,如Assets:Card:1234
。但第一层必须是以下五个账户之一,日常交易中涉及到的账户,一定可以归于其中某一类:
- 收入(Income):工资、投资收益等。
- 支出(Expenses):衣、食、住、行等。
- 资产(Assets):储蓄卡余额、支付宝余额、股票账户余额、房子、车子等。
- 负债(Liabilities):信用卡欠款、房贷、车贷等。
- 权益(Equity):这个账户比较特殊,在账户初始化、误差处理等少数场合使用。
开启日期可使用真实日期,若忘了了,我习惯使用自己的生日或开始复式记账的前一天(2019-06-30)。
开设账户时货币类型不是必须的,但建议加上,记录交易时货币不一致Beancount会报错。货币可设多个,用英文逗号(,)分隔。
最后,如果一个账户不再使用,比如注销信用卡。可用close
命令关闭账户。如下:
关闭日期 close 账户名
【初始化】
当我们开始记账时,一般资产和负债都不会是0,因此需要对资产和负债账户进行初始化。初始化的格式与交易明细完全一致,请参考正文的交易明细介绍。
唯一不同,初始化需要用到Equity账户。如示例中的Assets:Card:1234
,初始金额10000元来自Equity:OpenBalance
。
交易明细
账户设置中的初始化,和交易明细有关,因此先介绍交易明细的记录格式。如下:
日期 * "交易方" "交易备注"
账户 金额 货币
账户 金额 货币
其中
*
号表示这笔交易是确定的,没有疑问。若是!
号,表示存疑,但一般用不上。- 交易方和交易备注,均可省略。
- 货币必须与账户设置中对应的货币类型一致。比如账户设置为美元账户,消费时出现人民币,Beancount会报错。
此外,账户后的金额是带有符号的,如下:
- 支出账户:一般为正数。表示花费多少钱。
- 收入账户:一般为负数。表示收入多少钱。投资收入账户可能出现正数,则表示投资亏损。
- 资产账户:可正可负。正数表示有钱存入,余额增加;负数表示有钱转出,余额减少。
- 负债账户:可正可负。正数表示还款,负债减少;负数表示借款,负债增加。
支出为正,收入为负,有点反直觉,是会计恒等式逻辑所致。会计恒等式具体表述如下:
(Assets + Expenses) + (Liabilities + Income) + Equity = 0
一笔交易记录可能涉及2个以上的账户,比如例子中的「工资收入」,这时,多个账户的金额也满足「有正有负,正负相等」。实际记录时,Beancount允许一个账户的金额为空,它会根据正负相等的原则自动计算。
看到这里,已经可以开始动手记账了。开设好账户,然后初始化,最后每天记录交易。
三、Beancount实践
下面是些个人使用经验,供参考。
编辑器
我使用的是VSCode编辑器,配合Beancount
插件(by Lencerf),能够实现语法着色、账户自动补全、数字按小数点对齐、错误提示等,大大提高记账效率。
拆分账本
如果按前面的方法记账,一段时间后会发现:随着交易增加,账本文件越来越大,维护不方便。
Beancount允许将账本拆分,然后通过include
语法将账本进行关联起来。比如,我的账本结目录构如下:
beancount
├── 2018
│ ├── 2018.bean
│ └── yuegangzhoudian.bean
├── 2019
│ ├── 2019.bean
│ ├── 0-default
│ │ ├── 00.bean
│ │ ├── 07-expenses.bean
│ │ ├── 08-expenses.bean
│ │ ├── 09-expenses.bean
│ │ ├── 10-expenses.bean
│ │ ├── event.bean
│ │ ├── income.bean
│ │ └── transfer.bean
│ ├── 1-securities
│ │ ├── 00.bean
│ ├── 2-trip
│ │ ├── 00.bean
│ │ ├── 20190708-beijing.bean
│ │ ├── 20190720-yiwu.bean
│ ├── 3-cycle
│ │ ├── 00.bean
│ │ ├── bankcard.bean
│ │ ├── creditcard.bean
│ │ ├── cycle-expenses.bean
│ │ └── loans.bean
│ ├── 4-project
│ │ ├── 00.bean
│ └── 5-doc
│ ├── 2019-note.md
│ ├── creditcard-bill
│ └── note.xlsx
├── accounts
│ ├── assets.bean
│ ├── equity.bean
│ ├── expenses.bean
│ ├── income.bean
│ └── liabilities.bean
|── main.bean
最底下的main.bean
是我的主账本(查账执行fava main.bean
)。该文件的内容如下:
;==main文件==
;【一、账本设置】
option "title" "我的账本"
option "operating_currency" "CNY"
1990-01-01 custom "fava-option" "language" "zh"
;【二、账户设置】
include "accounts/assets.bean" ;资产账户设置及初始化
include "accounts/liabilities.bean" ;负债账户设置及初始化
include "accounts/expenses.bean" ;支出账户设置
include "accounts/income.bean" ;收入账户设置
include "accounts/equity.bean" ;权益账户设置
;【三、交易记录】
include "2018/2018.bean" ;历史账本合集
include "2019/2019.bean" ;2019年账本合集
我使用include
导入了7个文件,其中5个账户设置文件,2个年度账本。
我2019年年度账本如下:
;==2019.bean文件==
;2019年每个账本文件的描述
include "0-default/00.bean" ;默认目录,每月日常支出,收入,转账等
include "1-securities/00.bean" ;证券投资目录
include "2-trip/00.bean" ;旅行&出差目录
include "3-cycle/00.bean" ;周期性费用/交易目录
include "4-project/00.bean" ;项目目录
2019.bean
文件仍然没有交易记录,而是继续导入其它账本。
概括起来,我的账本结构分三层:
最1层:main.bean
作为主账本,include各个账户文件及每年账本文件。
第2层:每年有个目录,下设年份.bean
的文件,include各个子目录下00.bean
文件。
第3层:每个子目录下00.bean
文件include该目录下所有正式的记账文件。
年份目录下各子目录功能如下:
- 默认目录(0-default):日常支出,每月一个文件,也包括当年的收入、转账、event事件。
- 证券投资(1-securities):股票和基金买卖记录。
- 旅行出差(2-trip):旅行出差的账本,命名
日期-地点.bean
- 周期性账(3-cycle):包括每月信用卡还款、水电费、车贷房贷等。
- 项目目录(4-project):比如装修房子
这样设计优点:
- 按年组织,往年数据直接存档,不会被破坏
- 年份目录下进行分类记录,避免放在一个文件不好维护
定期断言
前面介绍复式记账优点时提到:
这种方式能够保证记账准确无误。
在Beancount中通过balance
实现账户核对。
假设在10月17日24点,尾号1234的银行卡余额为5000元,记录如下:
2019-10-18 balance Assets:Card:1234 5000.00 CNY
Beancount会自动汇总10月17日(含)以前尾号1234的银行卡所有收支,如果历史交易记录无误,那么计算出来也应该是5000元。若不是5000元,则Beancount报错,表示历史交易记录有误。
细心的朋友会发现,10月17日24点余额,balance时使用2019-10-18。
我一般每月对所有账户进行一次断言,频繁使用的账户月中会视情况穿插几次断言,避免错误。
错误/误差处理
如果断言报错,一般我会回溯,因为每月有断言的习惯,所以最多回溯一月数据即可。若无法回溯,则使用Euqity:UFO
记录。
假如断言时发现Assets:Card:1234
少了200元,则在断言前增加:
2019-10-18 * "" ""
Assets:Card:1234 -200.00 CNY
Equity:UFO
另一个错误场景是误差。假如存在四舍五入的误差,我用Equity:Round
处理,比如:
2019-10-09 * "支付宝基金" "购买基金110011易方达中小盘混合"
Assets:Bank:CMB:XXXX -450.00 CNY
Assets:Alipay:Fund 85.05 FD_110011 {5.2830 CNY}
Expenses:Commission:AlipayFund 0.67 CNY
Equity:Round
Equity
账户是个很特别的存在,可以处理边缘情况。我设置了四个Equity
账户如下:
Equity:OpenBalance
用于初始化Equity:HistoryIncome
开始复式记账(2019-07-01)前的部分收入Equity:Round
四舍五入操作Equity:UFO
无法追溯的差额
多币种及货币转化
账户可以根据实际情况设置多个货币。比如Visa信用卡美元消费以美元入账,则需要支持美元。
对于美元消费以人民币入账,可以使用@@
进行货币转化。比如,本博客的服务器账单如下,3.71美元以26.57入账。
2019-10-04 * "Amazon" "付lightsail服务器月账单"
Liabilities:CreditCard:SPDB:XXXX -26.57 CNY
Expenses:Digital:Software 3.71 USD @@ 26.57 CNY
在option
中设置账本货币时,通常只需要一种主货币,Fava显示时,非主货币都会放进「其它」那一列,如图1。
标签
一个问题:约会时的用餐,该记在哪个账户?
可以记在Expenses:Food
饮食支出账户,也可以记在Expenses:Date:Food
约会分类下饮食。如果使用后者,Food类账户越来越多,不便于维护。
此时,我一般使用前者,并借助Beancount提供的标签功能。如下:
2019-10-18 * "" "" #Date
Assets:Card:1234 -200.00 CNY
Expenses:Food
其中#Date
是标签,在Fava上可以筛选标签,查看该标签下各个账户的收支。
再比如,每次旅游,我会给旅游中所有的花费打上类似#20191001-hangzhou
的标签,带有日期和目的地。通过筛选标签,轻易的查看旅游中的吃、住、行、玩等等花销。
旅行的交易通常很多,一条条添加标签比较繁琐,Beancount支持使用pushtag
和poptag
给多笔交易加上标签。
pushtag #20191001-hangzhou
2019-10-18 * "" ""
Assets:Card:1234 -200.00 CNY
Expenses:Food:Dinner
2019-10-18 * "" ""
Assets:Card:1234 -20.00 CNY
Expenses:Traffic:Taxi
poptag #20191001-hangzhou
这样,在pushtag
和poptag
之间的所有交易,都会带上#20191001-hangzhou
标签.
事件
生活中可能有些事件希望被记录,这已经和记账没多大关系了,不过Beancount也支持,格式:
日期 event "事件分类" "事件详情"
比如我的事件举例:
;beancount事件
2019-06-30 event "beancount" "启用beancount"
;工作事件
2019-08-30 event "work" "神马lastday"
2019-09-02 event "work" "今天开始在AE上班"
;旅行或出差记录location事件
2019-09-13 event "location" "杭州->苏州:去程"
2019-09-15 event "location" "苏州->杭州:回程"
然后Fava界面有事件查看界面。
四、结语
没想到写了这么多,断断续续也写了多天,有点意犹未尽。
学习过程中,除了byvoid的文章,还参考了wzyboy和Beancount —— 命令行复式簿记和官方文档
能用这种方式去记账,很大程度上利益于移动支付的普及。熟练之后,每天晚上对照支付宝和微信账单,3分钟就能记完。
当然,这仍然不是最好的方式,wzyboy已经实现了import,每月花一两个小时处理一次即可。我觉得import的方式得到的信息不够丰富和详细,所以没有深入研究。
Beancount还有些高级应用,比如记录证券投资,使用BQL语句统计分析。各种满足工具控的折腾欲。
最近更新:2019-10-19
感谢楼主的分享,教程写得真好!我之前用挖财记账了几年了,依赖他的短信自动入账功能,但是有时候正因为这个「方便」的功能所以经常会拖延好长时间不记账,后续再补记账就非常痛苦。所以我想尝试换到Beancount来试一试这种比较原始的记账工具,看下是不是其实成本更低,我已经按照楼主的教程创建了Beancount的账本开始记账了,每天记账的时间成本确实没有比用图形界面的记账软件多,甚至其实更方便。
楼主的账本分类非常清晰,我也直接借鉴了,只是去掉了「2019/0-default/00.bean」这个文件,直接在「2019/2019.bean」文件中用通配符引入这个默认目录下的所有bean文件,如「include "0-default/*.bean" 」。请问下楼主设置「2019/0-default/00.bean」这个文件的目的是为了用来给这个目录下的每个文件做注释吗?因为我看除了月份之外还有其他类型的bean文件。
另外我想问个问题,理财收益应该属于Income:Invest的账户(投资收入),那么如果是理财亏损,应该是记账在Expenses:Invest账户还是Income:Invest账户呢?如果亏损也记录在Income:Invest账户的好处是,这个分类的数值代表理财最后的收益情况(可正可负),但是如果记录到Expenses:Invest中,虽然比较符合正常逻辑,但是查看实际最后的收益情况,则需要通过Income:Invest - Expenses:Invest,所以想问下楼主这块你是怎么记账的呢?再次感谢楼主分享这个优秀的教程!
1、我不晓得能用通配符,哈哈,这个值得学习,多谢分享。另外,如果对文件有注释,我会注释在文件中(前几行,想写多少写多少),不会在include file后面注释。
2、我都放在Income:Invest下面。主要是逻辑上更清晰,亏损属于收益,不是费用。另外,像你讲的,统计上也更方便。甚至,为了这个方便,我把交易过程中产生的手续费,也放到Income:Invest下面了,比如Income:Invest:Expenses,类似这样。
最后,这两年实践,也做过几次调整。核心逻辑是从自己的需求出发,最关心哪些问题,以方便这些问题的分析为目的设计账户结构。
最开始,我的交易费用放到Expenses下,但其实Expenses下我更关心日常支出费用,交易费用放这里意义不大,相反,把交易费用放在Income:Invest账户,更方便看投资的情况。
了解了。Income:Invest:Expenses 是一个很好的分类,我之前都没想到投资成本也是需要总结的一项,又学到了。确实如楼主所说,还是需要多实践复盘,找到适合自己的方式。感谢楼主解答~
请问后面文件的组织架构中的accounts文件里的assets.bean,equity.bean,expenses.bean,income.bean,liabilities.bean 这五个bean文件里面需要写的是什么,比如在“equity.bean”里面是否写“2021-08-02 open Equity:OpenBalance” 这样的字段么?。为什么我写了之后在fava里面查看一直报错,但是却是可以正常浏览的
「2021-08-02 open Equity:OpenBalance」是这样的,因为open日期是2021-08-02,所以后续在记账的时期必须在2021-08-02之后,不含08-12。
具体报什么错呢,可以贴一下
F:\accountsCode\2021\0-default\08-expense .bean 2
Invalid reference to inactive account 'Assets:Allcount'
按照你说的 我修改了时间 现在已经不报错了 感谢!
最近也尝试着在用,有几个问题请教一下:
关于基金,我有定投的习惯,遇到的问题是,当每笔定投金额从银行账户转入到基金账户时,因为交易延迟的原因(T+N 的需求),并不能立即获取所购买的基金份额、成本价、交易费等信息。像这种两个账户之间进出账时间相差一周左右的交易,怎样能比较好地去记录。我有想过设立一个中转账户,但觉得有点繁琐,所以找你请教一下;关于预算,我设置了某个账户的 “monthly” 预算,譬如300 CNY,在fava图表中看到的是,他把这300 CNY 均分到了月内每一天,即 “daily” 10 CNY,其实这个对我去做预算没啥参考意义。想知道如何能比较直观地看到月预算与本月对应账户的支出对比分析?关于筛选,我不是程序员,比较抓瞎。看参考文档似乎使用到一些命令的,看的一头雾水......如果您有时间的话,希望出一篇文章指引一下咱这些外行,抱拳!非程序员,问的都是一些很基础的问题,见笑哈!
哈哈,看的出来,你用的挺深入了,这三个问题,我也碰到过,说下我的处理:
1、定投,像你讲到的,中间账户太繁琐,没必要。我现在直接使用基金份额的确认日期,未确认前就当没银行卡没转出好了。不影响整体的记账和分析。
2、预算功能,我也注意到这个问题,后来就放弃了,没有再进一步研究。有空可以再琢磨一下,看看官方文档,不知道有没有详细解释。
3、指的是BQL查询吗,我涉猎的比较浅,一般只在年末的时候做一些分析。比如统计一下全年在哪个店消费的最多之类的。对我来说,fava上的基础筛选和统计功能已经足够用了,只差一个同比变化、环比变化。fava如果能增加同比增长和环比增长,就完美了。
PS:好奇你是什么网络环境,我的博客最近应该不能在大陆访问。
我有使用代理。
重看了这篇文章,还是晕,所以,我选择excel哈哈哈哈
我用过excel,配置模版比较费劲,但如果全部配置好了,也一劳永逸,同样很方便。
这种引用很有意思,什么原理,如何设置的?
这个叫Pingback,中文「引用」, Wordpress 繁体译「通告」,大概是引了你这篇的超链接所致。
类似的还有 Trackback, 中文 「参照」, Wordpress 繁体译「引用」,应该是需要主动填写而不是以超链接来判断。
最后,建议关闭该功能,防止 Spamming。
懂了,typecho找到了功能。
下载beancount的时候一直蹦出错误提示 ERROR: Command errored out with exit status 1:
请问是怎么回事呢?
另外,windows上安装python后,应该有个python专用的shell,用那个shell,不要有windows自带的shell
错误信息我看的也不是很懂,我自己用的mac,以前帮朋友在windows上安装成功过,没出现类似错误。
你这个看起来像是安装环境的问题,使用命令:python3 -m pip3 install 安装试试。
参考:https://stackoverflow.com/questions/58423367/how-to-fix-error-command-errored-out-with-exit-status-1-when-trying-to-inst
文件的组织架构真挺好,我也参考改进一下。刚开始用一周左右,希望能继续用下去~
坚持久点效果比较明显,重要的是每个月抽时间去分析下各个账户(beancount牛逼的还是报表清晰),把钱花在刀刃上。当然,如果能开源,就更牛逼了。
beancount就是开源的
这里我指「开源节流」的开源,哈哈~~
看晕了
哈哈,是不是把简单东西讲复杂了,写完我也有点觉得太长了……