8. 基础报告与 Web 界面 - Beancount 速读教程

在上一章中，我们深入探讨了余额断言（Balance Assertion）和 pad 指令，这是确保账本数据准确性的最后一道防线。通过这些机制，我们能够自动检测并修正账本中的微小误差，或者强制要求账本在特定时间点必须达到某个精确的余额。这标志着我们从单纯的“记账”阶段，迈向了“对账”和“审计”的阶段。

现在，当账本中的每一笔交易都经过了严格的校验，账户余额准确无误时，我们自然会问：如何将这些枯燥的文本数据转化为直观、有价值的财务洞察？这正是本章的核心——我们将目光从数据的“录入与校验”转向数据的“呈现与分析”。我们将学习如何使用 Beancount 内置的工具生成标准的财务报表，以及如何通过现代化的 Web 界面，以交互式的方式探索我们的财务世界。

基础报告命令概览

Beancount 生态系统提供了一系列命令行工具，用于从账本文件中提取和展示信息。其中，最核心的两个工具是 bean-report 和 bean-query。在本章，我们将主要聚焦于 bean-report，因为它提供了生成标准、格式化财务报表的最快捷路径。

bean-report 是一个多功能的报告生成器。它的基本用法非常简单：

bean-report <你的账本文件.beancount> <报告名称>

例如，要生成一份试算平衡表，你只需运行：

bean-report main.beancount balances

这个命令会将计算结果输出到标准输出（你的终端）。你也可以使用重定向将其保存为文件，例如：

bean-report main.beancount balsheet > balance_sheet.txt

bean-report 的强大之处在于它支持多种报告类型，并且许多报告支持不同的输出格式（如文本、HTML、CSV 等）。你可以通过 bean-report --help-reports 查看当前系统支持的所有报告类型列表。虽然列表很长，但日常使用中最核心的报告无非以下几种：试算平衡表、资产负债表、损益表和日记账。

三大核心财务报表

在会计学中，有三张报表是理解一个实体财务状况的基石。Beancount 完美地复刻了这些概念，并能从你的纯文本账本中瞬间生成它们。

试算平衡表 (Trial Balance)

试算平衡表是所有账户在某个时间点（通常是期末）的余额一览表。它的核心作用是验证你的复式记账是否“平衡”，即所有账户的借方余额总和是否等于贷方余额总和。在 Beancount 中，这通常是你检查账本整体健康状况的第一步。

生成命令：

bean-report main.beancount balances

输出示例（简化版）：

Assets
  Bank
    Checking Account          5,000.00 USD
    Savings Account           15,000.00 USD
  Investment
    Brokerage                 25,000.00 USD
Liabilities
  Credit Card                 -1,500.00 USD
Equity
  Opening Balances            43,500.00 USD
Income
  Salary                      -5,000.00 USD
Expenses
  Rent                         2,000.00 USD
  Food                         1,000.00 USD
-------------------------------------------
                                0.00 USD

这份报告清晰地列出了所有活跃账户的期末余额。注意，理想情况下，所有账户的总和应该为零（或接近于零，因为可能存在未实现损益等特殊情况）。这份报告是后续生成资产负债表和损益表的基础。

资产负债表 (Balance Sheet)

资产负债表是企业在特定时间点的“快照”，它展示了企业的资产、负债和所有者权益的构成。其背后的会计恒等式是：资产 = 负债 + 所有者权益。它回答了“我们现在拥有什么？”这个问题。

生成命令：

bean-report main.beancount balsheet

输出格式： 默认情况下，balsheet 报告通常以 HTML 格式输出，因为其双栏布局（资产在左，负债与权益在右）在浏览器中展示效果最佳。你可以将输出重定向到一个 .html 文件，然后用浏览器打开。

报告结构解析：

左侧：资产 (Assets)
- 流动资产（如现金、银行存款）。
- 长期资产（如投资、房产）。
右侧：负债 (Liabilities) 和所有者权益 (Equity)
- 负债（如信用卡欠款、贷款）。
- 所有者权益（这通常包括 Equity:Opening Balances 以及历年累积的净利润）。

这份报表清晰地告诉你，在扣除了所有债务后，你真正拥有多少净资产。

损益表 (Income Statement)

损益表（或称利润表）则是一段时期内的“录像”，它汇总了企业在该期间内的收入和支出，最终得出净利润或净亏损。它回答了“这段时间我们赚了（或亏了）多少钱？”这个问题。

生成命令：

bean-report main.beancount income

输出格式： 与资产负债表类似，损益表也默认以 HTML 格式输出，方便查看。

报告结构解析：

左侧：收入 (Income)
- 列出所有收入来源，如工资、投资回报、利息等。在 Beancount 的会计体系中，收入账户的增加通常表现为贷方（负数）。
右侧：支出 (Expenses)
- 列出所有费用类别，如房租、餐饮、交通、娱乐等。支出账户的增加表现为借方（正数）。
底部：净利润 (Net Income)
- 总收入 - 总支出 的结果。这个数字最终会结转到资产负债表的“所有者权益”部分，从而将两张报表联系起来。

日记账报告 (Journal Report)

除了上述宏观的汇总报表，我们有时也需要查看微观的交易明细。日记账报告就是为此而生，它类似于银行对账单，按时间顺序列出指定账户的所有交易。

生成命令：

bean-report main.beancount journal -a Assets:Bank:Checking Account

这里的 -a 参数用于指定要查看的账户。

输出示例：

2023-10-01 * "Company Inc." "October Salary"
  Assets:Bank:Checking Account      5,000.00 USD
  Income:Salary                    -5,000.00 USD

2023-10-02 * "Landlord" "October Rent"
  Assets:Bank:Checking Account     -2,000.00 USD
  Expenses:Rent                     2,000.00 USD

常用格式化选项： journal 报告非常灵活，支持多种选项来定制输出：

--balance 或 -b：在每笔交易后显示当前账户的累计余额。
--at-cost 或 -c：对于投资类账户，显示成本而非单位数量。
--compact 或 -x：压缩输出，不显示交易之间的空行。
--width <数值> 或 -w <数值>：限制输出的宽度。

通过组合这些选项，你可以得到非常符合个人习惯的交易流水单。

Web 界面导航：Fava

虽然命令行工具非常强大，但交互式的 Web 界面能带来完全不同的体验。Beancount 社区中，最流行、功能最完善的 Web 界面是 Fava。它是一个独立的项目，但与 Beancount 紧密集成。bean-web 是 Beancount 早期自带的 Web 服务器，但目前已不再积极维护，Fava 是当前事实上的标准。

安装与启动： 如果你已经通过 pip 或 pipx 安装了 Beancount，Fava 通常也会被一并安装。如果没有，可以单独安装：

pip install fava

启动 Fava 非常简单，只需指向你的账本文件：

fava main.beancount

命令行会提示你 Fava 正在运行，并提供一个本地地址（通常是 http://127.0.0.1:5000）。在浏览器中打开这个地址，你就能看到 Fava 的界面。

全局页面 (Global Pages)

Fava 的界面设计直观易用。顶部的导航栏提供了全局视图：

账本 (Ledger)：这是首页，通常显示一个仪表盘，包含账户余额总览、近期交易等。
损益表 (Income Statement)：直接链接到按年/月/日分组的损益表视图。
资产负债表 (Balance Sheet)：链接到资产负债表视图。
日记账 (Journal)：查看所有交易的流水账，并可以进行复杂的筛选。
持有 (Holdings)：查看你的投资组合，包括按账户、按资产类别等维度的聚合。
图表 (Charts)：提供各种可视化图表，如净资产趋势图、支出构成饼图等。
查询 (Query)：一个强大的界面，用于执行 BQL (Beancount Query Language) 查询。

视图特定页面 (View-Specific Pages)

Fava 的强大之处在于其“上下文感知”能力。当你在左侧的账户树中点击某个特定账户，或者在日记账中筛选出某个时间段（例如“2023年”）后，Fava 会进入一个“视图”。

在这个视图内，导航栏会增加一些新的选项卡，专门针对当前筛选出的数据集：

账户页面：当你点击一个账户时，会看到该账户的专用页面，显示该账户的日记账、余额历史等。
时间段页面：当你筛选出一个时间段后，会看到针对该时间段的期初余额 (Opening Balances)、期末余额 (Balance Sheet) 和 损益表 (Income Statement)。这让你能轻松地分析任意时间段的财务状况。

例如，你想分析 2023 年的财务状况：

在 Fava 顶部的过滤器中输入 year:2023。
按回车，整个界面会刷新，所有报告都将基于 2023 年的数据。
现在点击“损益表”，你看到的就是 2023 年的收入和支出情况。
点击“资产负债表”，你会看到 2023 年末的财务快照。

这种交互式的数据探索方式，远比命令行的一次性报告生成要灵活和强大。

本章小结

在本章中，我们学习了如何将账本中的原始数据转化为有意义的财务报告。我们掌握了 bean-report 命令，能够生成标准的试算平衡表、资产负债表和损益表，这些都是理解个人或企业财务健康状况的基础。更重要的是，我们引入了 Fava 这一现代化的 Web 界面，它极大地提升了我们与账本交互的效率和体验，通过可视化的、可交互的方式，让我们能够深入探索财务数据的每一个角落。

至此，我们已经完成了从记账、对账到报表生成的完整闭环。然而，我们的财务世界远不止于现金和银行存款。在下一章，我们将踏入更复杂的领域——投资交易与损益追踪，探讨如何处理股票、基金等投资品的买卖、分红以及如何精确计算投资收益。