Beancount 快速入门

准备好掌控你的财务了吗？本指南将帮助你在几分钟内启动并运行 Beancount。你将学习如何创建你的第一个账本，设置必要的账户，并记录你的第一笔交易。

初始设置

创建你的第一个账本

; 新账本的基本结构
2024-01-01 open Assets:Checking
2024-01-01 open Equity:Opening-Balances

2024-01-02 * "初始存款"
  Assets:Checking           100.00 USD
  Equity:Opening-Balances

必要的配置

option "title" "个人财务账本"
option "operating_currency" "USD"

文件组织

推荐结构

; 1. 配置选项
option "title" "个人账本"
option "operating_currency" "USD"

; 2. 账户声明
2024-01-01 open Assets:Checking    USD
2024-01-01 open Assets:Savings     USD
2024-01-01 open Expenses:Food      USD

; 3. 初始余额
2024-01-01 pad Assets:Checking Equity:Opening-Balances
2024-01-01 balance Assets:Checking 1000.00 USD

; 4. 交易
2024-01-15 * "杂货店" "每周购物"
  Expenses:Food            50.00 USD
  Assets:Checking

章节组织

1. 永久账户

   2024-01-01 open Liabilities:Payables    USD
   2024-01-01 open Assets:Receivables      USD

2. 银行账户

   2024-01-01 open Assets:Bank:Checking     USD
   2024-01-01 open Assets:Bank:Savings      USD
   2024-01-01 open Income:Bank:Interest     USD

3. 投资账户

   2024-01-01 open Assets:Investment:Cash    USD
   2024-01-01 open Assets:Investment:Stocks  VTSAX
   2024-01-01 open Income:Investment:Dividend USD

验证和报告

基本验证

# 检查错误
bean-check ledger.beancount

# 查看 Web 界面
bean-web ledger.beancount

常用报表

# 资产负债表
bean-report ledger.beancount balsheet

# 利润表
bean-report ledger.beancount income

# 账户明细
bean-report ledger.beancount journal -a Assets:Checking

管理初始余额

填充示例

2024-01-01 open Assets:Checking    USD

; 填充账户以匹配已知余额
2024-01-01 pad Assets:Checking Equity:Opening-Balances

; 断言已知余额
2024-01-01 balance Assets:Checking 1525.00 USD

账户关闭

2024-01-01 open Assets:OldBank:Checking   USD
2024-06-30 close Assets:OldBank:Checking  ; 账户已关闭

交易去重

处理转账

; 信用卡支付 - 组合视图
2024-01-15 * "信用卡支付"
  Assets:Checking            -500.00 USD
  Liabilities:CreditCard     500.00 USD

; 标记为待匹配
2024-01-15 * "待处理的信用卡支付"
  ! Assets:Checking         -500.00 USD
  Liabilities:CreditCard    500.00 USD

余额断言

; 定期余额检查可防止重复
2024-01-31 balance Assets:Checking    2150.25 USD
2024-01-31 balance Liabilities:CreditCard  -350.00 USD

最佳实践

1. 文件组织

   • 最初保持一个主文件
   • 使用清晰的章节标题
   • 将相关账户分组在一起

2. 账户名称

   • 使用一致的命名约定
   • 包含国家/机构前缀
   • 保持逻辑层次结构

3. 余额验证

   • 定期余额断言
   • 适当填充账户
   • 跟踪账户关闭

4. 货币处理

   • 声明运营货币
   • 使用一致的商品代码
   • 指定货币约束

下一步

现在你已经设置了一个基本的账本：

1. 记录常规交易：从你的日常支出和收入开始
2. 设置银行账户导入：使用 CSV 导入或银行连接来自动化数据录入
3. 学习高级语法：浏览 语法参考 以了解更复杂的场景
4. 生成你的第一份报表：使用 UI 功能创建财务报表并分析你的支出

快速参考

常用账户类型：

• Assets:Bank:Checking - 你的支票账户
• Expenses:Food:Groceries - 杂货支出
• Income:Salary:Company - 雇佣收入
• Liabilities:CreditCard:Visa - 信用卡债务

必要命令：

• bean-check ledger.beancount - 验证你的账本
• bean-report ledger.beancount balsheet - 生成资产负债表
• bean-web ledger.beancount - 启动 Web 界面

这些指南为使用 Beancount 管理个人财务奠定了坚实的基础。准备好添加你的第一笔交易了吗？查看我们的 UI 交易指南。