# 在 Beancount.io 中追踪房地产投资

管理出租房产的会计工作，涉及抵押贷款、代管账户（escrow）、折旧计划以及最终的房产出售，可能颇具挑战。本综合指南将向你展示如何使用 Beancount.io 强大的纯文本会计系统，建立并维护准确的房地产投资追踪。

探索一个真实的房地产示例账本：

<LedgerEmbed
  username="open_ledger"
  ledger="real-estate-example"
  page=""
  title="Real Estate Example Ledger"
/>

## 为什么传统工具不足

### 房地产会计软件的常见问题

- **无法追踪折旧**：大多数工具不支持采用月中惯例（mid-month convention）的 27.5 年直线折旧
- **抵押贷款处理粗糙**：简化的视图不会把还款拆分为利息、本金和代管账户
- **缺少成本基础调整**：增加成本基础的资本改良被当作普通费用处理
- **无法分解出售利得**：无法把出售所得拆分为折旧回收与长期资本利得
- **账户结构不灵活**：固定的类别无法容纳土地/建筑拆分或备抵资产账户
- **供应商锁定**：专有格式使你无法维护 27.5 年的连续记录

### Beancount.io 的优势

- **完全掌控**：以纯文本格式拥有你的数据，可保存数十年
- **无限定制**：用自定义账户为任何房产结构建模
- **精确的成本基础**：分别追踪原始成本、改良和折旧
- **透明的计算**：清楚看到折旧如何累积、利得如何计算
- **房产作为商品**：使用价格指令，在 Fava 持仓视图中追踪增值
- **面向未来**：纯文本格式确保在你的整个持有期内都能长期访问

## 设置你的物业账户结构

### 账户层级

从一套能反映你房地产投资的[完整账户结构](https://beancount.io/zh/docs/Tips/real-estate-templates-examples)开始：

```bean
; ============================================================
; Property Asset Accounts
; ============================================================

; The property commodity — 1 unit purchased at cost basis
1970-01-01 open Assets:RealEstate:Property
; Contra-asset: accumulated depreciation reduces building value on balance sheet
; Note: Land ($80K, 20%) is non-depreciable; Building ($320K, 80%) is depreciated
1970-01-01 open Assets:RealEstate:AccumDepreciation
; Capital improvements added to basis
1970-01-01 open Assets:RealEstate:CapitalImprovements

; ============================================================
; Bank Accounts
; ============================================================

1970-01-01 open Assets:Bank:Checking
1970-01-01 open Assets:Bank:Savings
; Escrow impound: monthly contributions for property tax & insurance
1970-01-01 open Assets:Bank:EscrowImpound

; ============================================================
; Liability Accounts
; ============================================================

; 30-year fixed mortgage at 7.0% APR
1970-01-01 open Liabilities:Mortgage
; Tenant security deposit — not income until forfeited
1970-01-01 open Liabilities:SecurityDeposit

; ============================================================
; Income Accounts
; ============================================================

1970-01-01 open Income:RealEstate:Rent
1970-01-01 open Income:RealEstate:CapitalGains:LongTerm
1970-01-01 open Income:RealEstate:DepreciationRecapture

; ============================================================
; Expense Accounts
; ============================================================

1970-01-01 open Expenses:RealEstate:MortgageInterest
1970-01-01 open Expenses:RealEstate:LoanOrigination
1970-01-01 open Expenses:RealEstate:PropertyTax
1970-01-01 open Expenses:RealEstate:Insurance
1970-01-01 open Expenses:RealEstate:PropertyManagement
1970-01-01 open Expenses:RealEstate:Repairs
1970-01-01 open Expenses:RealEstate:Maintenance
1970-01-01 open Expenses:RealEstate:Depreciation
; Buyer-side closing costs (purchase only). There is deliberately no
; SellingCosts expense account: costs of sale reduce the amount realized
; at closing instead — see Property Disposition below.
1970-01-01 open Expenses:RealEstate:ClosingCosts
```

### 带有元数据的商品定义

将你的房产定义为一个商品，以便进行投资组合式的追踪：

```bean
1970-01-01 commodity PROP123MAIN
  name: "123 Main St, Anytown, CA 90210"
  asset-class: "real-estate"

1970-01-01 commodity USD
```

这使 [Fava 的持仓视图](https://beancount.io/zh/docs/Basics/fava-options)能够将你房产的当前市场价值与股票、债券及其他投资一并显示。

## 物业收购跟踪

### 记录购买

追踪一笔 40 万美元的购买，20% 首付、30 年固定利率抵押贷款：

```bean
; Down payment — 20% of $400,000
2024-03-15 * "Escrow" "Down payment — 20% of $400,000"
  Assets:RealEstate:Property           1 PROP123MAIN {400,000.00 USD, 2024-03-15}
  Assets:Bank:Checking              -80,000.00 USD
  Liabilities:Mortgage             -320,000.00 USD
```

### 成交费用

将每项过户费用记录为单独的交易，以便清晰地审计：

```bean
2024-03-15 * "Lender" "Loan origination fee — 1% of $320,000"
  Expenses:RealEstate:LoanOrigination   3,200.00 USD
  Assets:Bank:Checking                 -3,200.00 USD

2024-03-15 * "Title company" "Title insurance, escrow fees, recording"
  Expenses:RealEstate:ClosingCosts      2,800.00 USD
  Assets:Bank:Checking                 -2,800.00 USD

2024-03-15 * "Appraiser" "Property appraisal"
  Expenses:RealEstate:ClosingCosts        450.00 USD
  Assets:Bank:Checking                   -450.00 USD
```

### 土地/建筑分配

美国国税局（IRS）要求将不可折旧的土地与可折旧的建筑分开。用注释记录分摊：

```bean
; Land / building cost allocation (from county assessor):
; County assessor shows 20% land ($80K) / 80% building ($320K).
; Only the building portion ($320K) is depreciated — see depreciation section.
; Source: County Assessor parcel record, assessed 2024-01-01
```

### 初始托管存款

贷款机构通常要求在过户时预存一笔初始代管账户资金：

```bean
; Initial escrow: 3 months property tax + 1 year insurance prepaid
; Property tax: ~$5,000/yr → $416.67/mo × 3 = $1,250.00
; Insurance: ~$1,800/yr prepaid
2024-03-15 * "Escrow" "Initial escrow impound — property tax (3 mo) + insurance (1 yr)"
  Assets:Bank:EscrowImpound              1,250.00 USD
  Expenses:RealEstate:Insurance          1,800.00 USD
  Assets:Bank:Checking                  -3,050.00 USD
```

## 抵押贷款管理

### 每月付款分解

每笔抵押贷款还款分为利息费用、本金减少和代管账户：

```bean
; 30-year fixed: $320,000 at 7.0% APR
; Monthly P&I: $2,129.06
; Monthly escrow: $566.67 ($416.67 tax + $150.00 insurance)
; Total payment: $2,695.73

; Month 1: Interest = $320,000.00 × 0.07 / 12 = $1,866.67
2024-04-01 * "Bank" "Mortgage payment — April 2024"
  Expenses:RealEstate:MortgageInterest    1,866.67 USD
  Liabilities:Mortgage                      262.39 USD
  Assets:Bank:EscrowImpound                 566.67 USD
  Assets:Bank:Checking                   -2,695.73 USD

; Month 2: Interest = ($320,000.00 - $262.39) × 0.07 / 12 = $1,865.14
2024-05-01 * "Bank" "Mortgage payment — May 2024"
  Expenses:RealEstate:MortgageInterest    1,865.14 USD
  Liabilities:Mortgage                      263.92 USD
  Assets:Bank:EscrowImpound                 566.67 USD
  Assets:Bank:Checking                   -2,695.73 USD
```

### 托管支付

追踪代管账户何时支付税费和保险：

```bean
; Semi-annual property tax disbursement
2024-09-15 * "County tax collector" "Property tax — first installment"
  Expenses:RealEstate:PropertyTax    2,500.00 USD
  Assets:Bank:EscrowImpound        -2,500.00 USD

; Annual insurance renewal
2025-03-15 * "Insurance company" "Homeowner insurance renewal — year 2"
  Expenses:RealEstate:Insurance      1,850.00 USD
  Assets:Bank:EscrowImpound        -1,850.00 USD
```

## 租金收入与物业管理

### 含物业经理费的总租金

分别追踪毛租金收入和物业管理费：

```bean
; Rent: $2,400/mo, PM fee: 8% = $192
; Net to owner: $2,208

2024-04-01 * "Tenant" "April 2024 rent"
  Assets:Bank:Checking                    2,208.00 USD
  Expenses:RealEstate:PropertyManagement    192.00 USD
  Income:RealEstate:Rent                 -2,400.00 USD
```

### 押金

押金是负债，不是收入：

```bean
; Receive deposit — creates liability
2024-03-20 * "Tenant" "Security deposit — 1 month rent"
  Assets:Bank:Checking                    2,400.00 USD
  Liabilities:SecurityDeposit           -2,400.00 USD

; Return deposit — eliminates liability
2025-11-01 * "Tenant" "Return security deposit — lease ended"
  Liabilities:SecurityDeposit            2,400.00 USD
  Assets:Bank:Checking                  -2,400.00 USD
```

### 租金上涨

清楚地记录租金上涨：

```bean
; 2025 rent increase: $2,400 → $2,500/mo
; New PM fee: 8% × $2,500 = $200
2025-01-01 * "Tenant" "January 2025 rent (increased to $2,500)"
  Assets:Bank:Checking                    2,300.00 USD
  Expenses:RealEstate:PropertyManagement    200.00 USD
  Income:RealEstate:Rent                 -2,500.00 USD
```

## 折旧跟踪

### 27.5 年直线法与月中惯例

美国住宅出租房产的联邦折旧规则（MACRS —— IRS 出版物 946）：

- **回收期**：27.5 年
- **方法**：直线法
- **惯例**：月中（首月和末月各算半个月）

```bean
; Building cost: $320,000 (80% of purchase price)
; Monthly depreciation: $320,000 / 27.5 / 12 = $969.70
; Half-month: $484.85

; First month — half-month (placed in service 3/15)
2024-03-31 * "Depreciation" "March 2024 — half-month (placed in service)"
  Expenses:RealEstate:Depreciation          484.85 USD
  Assets:RealEstate:AccumDepreciation      -484.85 USD

; Full months
2024-04-30 * "Depreciation" "April 2024"
  Expenses:RealEstate:Depreciation          969.70 USD
  Assets:RealEstate:AccumDepreciation      -969.70 USD

2024-05-31 * "Depreciation" "May 2024"
  Expenses:RealEstate:Depreciation          969.70 USD
  Assets:RealEstate:AccumDepreciation      -969.70 USD
```

在你持有该房产的每一个月都继续记录月度分录，并在出售当月按同样的月中惯例记录最后一个半月——参见[处置月份模板](https://beancount.io/zh/docs/Tips/real-estate-templates-examples)。从 2024 年 3 月中持有到 2025 年 11 月中，这一计划在 2024 年累积 9.5 个月的折旧，在 2025 年累积 10.5 个月：20 个月 × \$969.70 = \$19,394.00，正是下文出售中冲销的累计折旧。

### 对冲资产模式

备抵资产方法让原始房产成本保持可见，同时追踪累计折旧的减少：

- `Assets:RealEstate:Property` —— 始终显示原始成本（\$400,000）
- `Assets:RealEstate:AccumDepreciation` —— 随时间累积负余额
- **净账面价值** = Property - |AccumDepreciation| = 用于折旧的调整后基础

这种分离对于出售计算至关重要，因为你需要将原始成本、改良总额和折旧总额作为不同的数值。

## 基本改进与维修

### 关键区别

**维修**（当期扣除 —— 在发生当年可全额扣除）：

```bean
2024-05-18 * "HVAC Pro" "A/C repair — replaced capacitor"
  Expenses:RealEstate:Repairs             285.00 USD
  Assets:Bank:Checking                   -285.00 USD

2024-06-10 * "Joe's Plumbing" "Fix leaking kitchen faucet"
  Expenses:RealEstate:Repairs             180.00 USD
  Assets:Bank:Checking                   -180.00 USD
```

**资本改良**（增加成本基础 —— 当期不可扣除，在出售时减少利得）：

```bean
2024-08-12 * "Home Depot" "Replace water heater — 50 gal gas"
  Assets:RealEstate:CapitalImprovements  1,800.00 USD
  Assets:Bank:Checking                  -1,800.00 USD

2024-10-05 * "Lowe's" "New kitchen appliances — stove + dishwasher"
  Assets:RealEstate:CapitalImprovements  4,200.00 USD
  Assets:Bank:Checking                  -4,200.00 USD
```

### 如何决定

| 类别         | 示例                                     | 税务处理              |
| ------------ | ---------------------------------------- | --------------------- |
| **维修**     | 修理漏水的水龙头、更换电容器、修补屋顶   | 当期扣除（附表 E）    |
| **资本改良** | 新热水器、新家电、新屋顶、加建           | 增加成本基础          |
| **维护**     | 景观美化、害虫防治、清洁                 | 当期扣除（附表 E）    |

## 物业处置

### 出售收益计算

出售时，利得分为[折旧回收](/blog/2026/07/18/depreciation-recapture-explained-guide)和长期资本利得两部分。出售成本——销售佣金和卖方支付的过户费用——会减少出售的实现金额（IRS 出版物 544）；它们不是单独的营业费用：

```bean
; === Gain Calculation ===
;
; Purchase price:              $400,000.00
; + Capital improvements:      +  6,000.00
; - Accumulated depreciation:  - 19,394.00
; = Adjusted basis:            $386,606.00
;
; Sale price:                  $435,000.00
; - Selling costs (6%):        - 26,100.00 (itemized in the closing statement below)
; = Net proceeds:              $408,900.00
;
; Total gain:                  $ 22,294.00 (net proceeds - adjusted basis)
;   Depreciation recapture:    $ 19,394.00 (unrecaptured §1250 gain — taxed at max 25%)
;   Long-term capital gain:    $  2,900.00 (taxed at LTCG rates)
```

### 记录出售

在记录任何内容之前，先核对结算单。代管代理人从买方的 \$435,000.00 中扣除佣金、卖方过户费用和抵押贷款清偿额，并将余额电汇给你——每一项扣除只发生一次：

```bean
; === Closing Statement ===
;
; Contract price:              $435,000.00
; - Sales commission (5%):     - 21,750.00
; - Seller closing costs (1%): -  4,350.00
; = Net proceeds:              $408,900.00
; - Mortgage payoff:           -314,744.09
; = Cash wired to seller:      $ 94,155.91
```

将过户记录为两笔分录。清偿额清掉剩余的贷款本金——即贷款机构在 2025 年 10 月还款后的清偿报价。处置分录收到 \$408,900.00 的净所得：\$26,100.00 的出售成本已从该数字中扣除，因此没有单独的佣金或过户费用从支票账户支付：

```bean
; Mortgage payoff — remaining principal per the lender's payoff quote
2025-11-15 * "Bank" "Mortgage payoff at closing"
  Liabilities:Mortgage                  314,744.09 USD
  Assets:Bank:Checking                 -314,744.09 USD

; Dispose property and recognize gain — the cash posting is net of the
; $26,100.00 selling costs, which reduce the amount realized at closing
2025-11-15 * "Sale" "Dispose property — recognize gain"
  Assets:RealEstate:Property              -1 PROP123MAIN {400,000.00 USD, 2024-03-15}
  Assets:RealEstate:CapitalImprovements   -6,000.00 USD
  Assets:RealEstate:AccumDepreciation     19,394.00 USD
  Assets:Bank:Checking                   408,900.00 USD
  Income:RealEstate:DepreciationRecapture -19,394.00 USD
  Income:RealEstate:CapitalGains:LongTerm  -2,900.00 USD
```

两笔分录合计使支票账户的变动恰好等于电汇金额：流入 \$408,900.00，流出 \$314,744.09，净额 \$94,155.91。不要再把佣金或过户费用记录为费用支付——那会从现金中第二次扣除同样的 \$26,100.00，并使收入错报同样的金额。注意，实现的利得（\$22,294.00）与你最终拿到的现金（\$94,155.91）是不同的数字：利得比较的是净所得与调整后基础，而现金是清偿贷款后剩余的部分。

## 投资组合表现

### 用于增值跟踪的价格指令

设置每季度的房产估值：

```bean
2024-03-15 price PROP123MAIN  400,000.00 USD
2024-06-30 price PROP123MAIN  405,000.00 USD
2024-09-30 price PROP123MAIN  412,000.00 USD
2024-12-31 price PROP123MAIN  418,000.00 USD
2025-03-31 price PROP123MAIN  425,000.00 USD
2025-06-30 price PROP123MAIN  430,000.00 USD
```

房产估值的来源：Zillow Zestimate、Redfin 估值、可比销售或专业评估。

[实时价格](https://beancount.io/zh/docs/live-prices)可以为你的托管账本中的其他持仓提供支持的市场报价和货币对。它不会对房产进行评估，也不会为自定义的房产商品定价。继续用你自己的带日期指令记录房产估值。

### Fava 持仓视图

将房产建模为商品后，Fava 的持仓视图会显示：

- **成本基础**：原始购买价格
- **市场价值**：基于最新的价格指令
- **未实现利得**：自购买以来的增值

这使你能够在统一的投资组合视图中，将房地产与股票、加密货币及其他投资一并查看。

## 税务优化策略

### 附表 E 分类

Beancount 的账户结构可直接对应附表 E 的各个行项：

| 附表 E 行项                   | Beancount 账户                            |
| ----------------------------- | ----------------------------------------- |
| 第 3 行（收到的租金）         | `Income:RealEstate:Rent`                  |
| 第 5 行（广告）               | `Expenses:RealEstate:Advertising`         |
| 第 8 行（保险）               | `Expenses:RealEstate:Insurance`           |
| 第 9 行（法律/专业服务）      | `Expenses:RealEstate:Legal`               |
| 第 10 行（管理费）            | `Expenses:RealEstate:PropertyManagement`  |
| 第 12 行（抵押贷款利息）      | `Expenses:RealEstate:MortgageInterest`    |
| 第 14 行（维修）              | `Expenses:RealEstate:Repairs`             |
| 第 16 行（税费）              | `Expenses:RealEstate:PropertyTax`         |
| 第 18 行（折旧）              | `Expenses:RealEstate:Depreciation`        |

### 1031 交换概念

[1031 交换](/blog/2026/07/27/1031-like-kind-exchange-small-business-guide)通过将资金再投资于同类房产来递延资本利得和折旧回收。虽然完整实施需要注册会计师的指导，但 Beancount 可以通过元数据和备忘分录来追踪递延利得。

## 报告与分析

### 净租金收入查询

```sql
SELECT account, sum(position) as total
WHERE account ~ "Income:RealEstate" OR account ~ "Expenses:RealEstate"
GROUP BY account
ORDER BY total;
```

### 现金流分析

```sql
-- Monthly net cash flow from property
SELECT year(date), month(date), sum(position) as net_flow
WHERE account ~ "Assets:Bank:Checking"
  AND (narration ~ "rent" OR narration ~ "Mortgage" OR narration ~ "repair")
GROUP BY year(date), month(date)
ORDER BY year(date), month(date);
```

### 年末验证

使用余额断言在报税前发现错误：

```bean
2025-01-01 balance Assets:RealEstate:Property    1 PROP123MAIN
2025-01-01 balance Assets:RealEstate:CapitalImprovements  6,000.00 USD
2025-01-01 balance Assets:RealEstate:AccumDepreciation   -9,212.15 USD
2025-01-01 balance Liabilities:SecurityDeposit           -2,400.00 USD
```

## 最佳实践与提示

### 1. 记录土地/建筑分配

在注释中记录县评估员的分摊结果，并注明来源和日期。IRS 可能会对激进的建筑分摊提出质疑。

### 2. 每月跟踪折旧

尽管折旧是按年申报的，但月度分录能让你的资产负债表保持准确，并使年终处理变得简单。

### 3. 仔细分类改进与维修

拿不准时，查阅 IRS 出版物 527。资本改良（增加成本基础）与维修（当期扣除）之间的区别，可能为你省下或损失数千美元。

### 4. 使用余额断言

每季度对余额进行断言。如果 `bea --file <file> check` 报告断言失败，你就能及早发现数据录入错误。

### 5. 将押金保留为负债

在押金被依法没收之前，绝不要将其记录为收入。

### 6. 维护价格指令

使用可比销售、Zillow 估值或专业评估，每季度更新房产估值。

### 7. 为出售做计划

保持账户整洁，这样在时机到来时，出售计算的两边都已计算完毕：调整后基础（原始成本 + 改良 - 累计折旧）和实现金额（出售价格 - 出售成本）。

## 结论

有效的房地产投资追踪需要精确、一致性和合适的工具。Beancount.io 提供了在整个投资生命周期内管理复杂出租房产会计所需的灵活性和强大功能。

使用 Beancount.io 追踪房地产的主要好处：

- **完全的数据所有权**：你的数据以纯文本格式保存，可延续数十年
- **精确的成本基础**：分别追踪购买、改良和折旧
- **可报税的报告**：账户结构直接对应附表 E
- **投资组合视图**：将房产建模为商品，可与 Fava 持仓集成
- **面向未来**：开放格式确保在 27.5 年折旧期乃至更长时间内都可访问

从一处房产开始，随着投资组合的增长扩展你的追踪。在正确设置上的投入，会在准确的报告、税务优化和安心无忧上带来回报。

准备好掌控你的房地产会计了吗？[立即开始使用 Beancount.io](https://beancount.io/sign-up)。
