记账神器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 favaFava是关联软件，为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 CNYBeancount会自动汇总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:RoundEquity账户是个很特别的存在，可以处理边缘情况。我设置了四个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
作者您好，感谢您的文章，给我提供了思路和明确的实践路径。关于初始化资产设置的问题想向您请教下：
我的目录结构跟您是一致的，我是在 accounts/assets.bean 中设置期初余额，示例如下：
2024-09-01 open Assets:Cash:CN:CNY CNY ;人民币现金
2024-09-01 * "" "期初余额"
equity.bean 和 assets.bean 都在 accounts 目录下，同时 equity.bean 设置：
;权益账户
2024-09-01 open Equity:Opening-Balances
但是 Visual Code 对 assets.bean 文件一直报错『Invalid reference to unknown account 'Equity:Opening-Balances'』 ，不过我运行 fava main.bean 没有显示错误，另外，已经安装 Beancount by Lencerf 的插件。
想请教下，1）不知道博主有没有碰到这个问题；2）因为该问题，所以也想请教下博主您的初始化资产是怎么做的？
应该是开户日期，open的日期要比第一笔账早才行。如果你第一笔账是2024-09-01，那么开户得提前到2024-08-31
请问下 历史 Alipay、Wx 账单有什么好的处理方式么，使用CSV-Importer 总有很多报错
估计只能自己写脚本了，我没处理历史账目的需求，没研究过。
请问一下 /accounts 下面的账户，比如 assets.bean、equity.bean 之类的用户该如何设置
请问是指在这些账户中初始化后，其他文件如 0-default/01-expenses.bean 中就能直接使用到这些账户了吗
是的哈，初始化后就能在其它账户中使用。
Firefly III 也挺香的
beancount中积累了几年的收支数据，已经习惯了，过了记账工具的阶段，哈哈。
大神，我现在完全不会弄，我安装了python，然后用科学上网在cmd输入pip的beancount和fava安装了这两个东西，然后我在进行下一步就是蒙德，我用系统自带的文本软件把内容复制进去并改成bean结尾的文件，此时文件在桌面，然后我输入C:\Users\J>fava moneybook.bean
Usage: fava [OPTIONS] [FILENAMES]...
Try 'fava --help' for help.
Error: Invalid value for '[FILENAMES]...': File 'moneybook.bean' does not exist.就再也进行不下去了。。。。
你现在所在目录是C:\Users\J
但你说你的文件在桌面，你可以把moneybook.bean复制到C:\User\J，再运营fava试试。
总之，运行fava moneybook.bean时，要保证这个文件在当前目录中。
我丢我终于弄好了，原因就是系统自带的文本txt软件并不能通过命名的方式改变文件的属性，就好比我把命名写成moneybook.bean 虽然后缀是bean但是这个文件依然是txt（类似于moneybook.bean.txt ，但是我刚刚用notepad++创建的文本文件在另保存时改为bean文件属性就真的变成了bean，然后再CMD输入fava money book.bean就弹出来ui的网址了。。。。。我想说，这个开源软件真是挺难弄的，尤其是我没安装PIP时，在GITHUB下载了beancount， fava的zip文件包，但却不知道如何用最后还是去找了python的pip配置方法，有了pip还需要梯子，没有梯子在输入pip install beancount 会弹出一堆的红色字母。真是太曲折了，对于我这种没有程序员背景的人，想用开源软件真是太难了，这个软件搜遍全网都没有视频教学，所以刚刚弄好的一瞬间，我丢感觉太帅了，终于弄好了。不容易，也幸好博主给了个提示，就是cmd所在的路径敲击命令，就要把文件也放在对应的路径中。
但其实我还是很好奇我有了源码的zip包，怎样不使用pip命令去安装或者说使用这个软件。
恭喜恭喜。
不用pip安装的方法我也不太清楚，我都用pip安装，很方便。不过，确实需要对命令行工具有些了解。事实上，pip安装可以切换到国内镜向地址，这样就不用梯子了。
楼主，今天开始记账，发现一个问题，按照你的方式规划目录后，比如编辑08.mean时不会提示建账户了，因为并没有导入账户文件识别不到，请问如何解决?
「不会提示建账户」是什么意思？「不会提示已建账户？」
如果是后者，我没碰到这个问题，没有更多信息不太清楚怎么加事。
有个beancount的tg群，挺活跃的，大家都在里面讨论使用技巧，咨询问题，可以考虑在这里咨询一下，看看有没有人遇到类似问题。
tg群地址：https://t.me/beancount_zh
telegram有一次验证超时，现在加不进了，能帮忙解禁一下？我说的就是没法提示自建账户，因为是在另一个文件，如果没include到08.bean，单独编辑08.bean时并不知道自建了哪些账户，感觉也符合逻辑。你的不会吗？它怎么知道你自建了哪些账户的？没想明白
fava执行的是一个main.bean文件，所有文件都会在main.bean中include的，包括账户类目文件，比如下面这个是我的main.bean文件
;设置账本标题
option "title" "我的账本"
;设置账本主货币
option "operating_currency" "CNY"
;option "operating_currency" "USD"
;option "operating_currency" "HKD"
;option "operating_currency" "AUD"
;导入账户
include "accounts/assets.bean"
include "accounts/liabilities.bean"
include "accounts/expenses.bean"
include "accounts/income.bean"
include "accounts/equity.bean"
include "accounts/commodity.bean"
;每年账本
include "2018/2018.bean" ;历史账本合集
include "2019/2019.bean" ;2019年账本合集
include "2020/2020.bean" ;2020年账本合集
include "2021/2021.bean" ;2021年账本合集
include "2022/2022.bean" ;2022年账本合集
include "2023/2023.bean" ;2023年账本合集
我说的不是fava浏览的时候，说的是记账的时候，比如我要在子目录2023里的08.bean记今天买了一瓶水，用的农行信用卡消费，那我在输Expenses:CreditCard:农行这个账户时是不是应该边输边提示，但实际没有，08.bean里并没有include 这些账户信息，账户信息写在account/Expenses.bean，这时并没有打开，也没打开main.bean，你是怎么做到这样的目录结构下记账时能有账户提示的？也就是输入的时候能弹出所有账户供选择。当然我是有装插件的，我使用vim，装了vim-beancount插件。
我用的是vscode，vscode的插件支持提示，不清楚是不是vim插件的原因。
可以试试vscode，插件是： https://marketplace.visualstudio.com/items?itemName=Lencerf.beancount
我加不了群，能麻烦帮我叫管理员放行下吗？我是fly fish
q
感谢楼主的教程，昨天接触的beancount，今天又陆续看了不少文章，跃跃欲试，不过在选择编辑器时我想使用vim，有没有vim方面的编辑技巧教程，装了个vim-beancount实现了高亮，其他不大会搞。谢谢!
您好，有个问题想请教一下
fava web UI界面中，事件菜单下列出了所有的event，每个event的发生日期是可以点击的，但是点击会报错"Loading entry context failed..."，不知道你使用过程中这个问题是怎么处理的，感谢~
我试了下，没有，点击日期也是进入到编辑状态，和收支记录点击效果一样。
请教一下大佬，如果我有房贷80万，需要像下面这样初始化房贷额度吗？
1990-07-01 * "房贷" "初始化余额"
然后每个月再记录还房贷：
2022-08-03 * "房贷"
是的。
可以这样理解：
资产负债属于状态，状态是要初始化的
收入支出属于过程，过程无所谓初始化
感谢大佬哇！讲的太好了😭
大佬您好，在学习您的目录结构，但是遇到了以下报错，请问怎么解决呀；易损表没有任何消费数据。
"File glob "0-default/07-expenses.bean" does not match any files"
看错误代码，意思就是0-default目录下没有07-expenses.bean文件，应该是目录名或文件名不对。
谢谢大佬，是我对文件层级没理解透，解决啦！
谢谢您的教程，写的真好！研究了两天，正式开始入坑！👍