# 从 QuickBooks 迁移到 Beancount：切换指南

选定一个切换日期，导出切换日前一天的 QuickBooks 试算平衡表，然后为每个资产负债表科目各写一条 `pad` 和一条 `balance` 来开立你的 Beancount 总账。当 `bea check` 通过、且权益余额与 QuickBooks 一致时，你的账本就完成了迁移。切换日之后的一切都记录在 Beancount 里。

本指南同时适用于 QuickBooks Online 和 QuickBooks Desktop。它不依赖任何 QuickBooks 导入器，因为 Beancount 并不自带。你先迁移余额，再决定要带多少历史数据。

如果你还在犹豫是否该换，请先读[Beancount 与 QuickBooks 对比](/compare/beancount-vs-quickbooks)。

## 1. 决定切换日期以及要保留什么

选一个财年的第一天，比如 `2026-01-01`。以年度为界可以让一个纳税年度只留在一个系统里。这也意味着你在 Beancount 里的第一份利润表从零开始。

现在就决定 Beancount 里要放多少历史数据：

- **只放余额。** 在切换日开账，把 QuickBooks 报表作为更早年份的存档。这是最快的路径，本指南余下部分都基于这一假设。
- **年度汇总。** 根据每一年的试算平衡表，为过去的每一年各加一条汇总分录。这样你的跨年报表在 Beancount 里也能用。
- **完整交易历史。** 用脚本转换总账（General Ledger）导出文件。这是工作量最大的一种，第 5 节会说明它涉及什么。

在 QuickBooks 里把每个银行和信用卡账户都核对到切换日的前一天。一个未核对的余额会把它的差错带进你的新总账。

## 2. 从 QuickBooks 导出

你需要三份报表，全部截止到切换日的前一天（本指南中为 `2025-12-31`）：

| 报表 | 它能给你什么 |
| --- | --- |
| Account List（科目列表） | 每个账户的名称和类型，用于第 3 步的映射 |
| Trial Balance（试算平衡表） | 每个账户的期末余额，将成为你的期初余额 |
| General Ledger（总账） | 每一笔交易，用于历史数据和存档 |

**QuickBooks Online。** 进入 **Reports**，然后 **Standard reports**，按名称打开每份报表。选择 **Export/Print**，然后 **Export to Excel**。Account List 就是会计科目表报表。**Settings** 里 **Tools** 栏下的 **Export data** 工具会把一组报表和列表作为 Excel 文件导出到一个 zip 包中。Intuit 在 [Export your QuickBooks Online data](https://quickbooks.intuit.com/learn-support/en-us/help-article/list-management/export-reports-lists-data-quickbooks-online/L1xleDrLp_US_en_US) 中记录了两条路径。

这些 QuickBooks Online 导出文件都是 Excel 文件。如果要用脚本读取，用电子表格打开每一个，另存一份 CSV 副本。

**附件（Attachments）** 需要单独导出。在 QuickBooks Online 中，进入 **Settings**，然后 **Attachments**，选中这些文件，选择 **Batch actions** 再选 **Export**。把这个 zip 和你的存档放在一起。

**QuickBooks Desktop。** 在 Windows 上，从 **Reports** 然后 **Reports Center** 打开每份报表。选择 **Excel**，然后 **Create New Worksheet**。下一个窗口可以直接保存为 Excel 工作簿或 CSV 文件，详见 [Export reports as Excel workbooks](https://quickbooks.intuit.com/learn-support/en-us/help-article/export-reports/export-reports-excel-workbooks-quickbooks-desktop/L4cLJEeXt_US_en_US)。Desktop 还可以把列表（包括会计科目表）导出为 IIF 文件：**File**，然后 **Utilities**，然后 **Export**，再选 **Lists to IIF Files**。IIF 导出只覆盖列表。Intuit 表示你可以导入交易但无法导出交易，详见 [Export, import, and edit IIF files](https://quickbooks.intuit.com/learn-support/en-us/help-article/import-export-data-files/export-import-edit-iif-files/L56LT9Z0Q_US_en_US)。

保持原始导出文件不变。如果日后有数字受到质疑，它们就是你的证据。

## 3. 把账户映射到 Beancount 层级

Beancount 有五个根账户。每一种 QuickBooks 账户类型都归入其中之一下：

| QuickBooks 账户类型 | Beancount 账户 |
| --- | --- |
| Bank | `Assets:Bank:Checking`、`Assets:Bank:Savings` |
| Accounts receivable (A/R) | `Assets:AccountsReceivable` |
| Other Current Assets、Fixed Assets | `Assets:Prepaid:…`、`Assets:Equipment:…` |
| Credit Card | `Liabilities:CreditCard:Visa` |
| Accounts payable (A/P)、Other Current Liabilities | `Liabilities:AccountsPayable`、`Liabilities:SalesTax` |
| Long Term Liabilities | `Liabilities:Loans:…` |
| Equity、Retained Earnings、Opening Balance Equity | `Equity:Opening-Balances` |
| Income、Other Income | `Income:Sales`、`Income:Interest` |
| Cost of Goods Sold | `Expenses:COGS:…` |
| Expenses、Other Expense | `Expenses:Rent`、`Expenses:Software` |

账户名以大写字母开头且不含空格，所以 "Office Supplies" 变成 `Expenses:Office-Supplies`。QuickBooks 的子账户变成更深的层级，比如 `Expenses:Vehicle:Fuel`。

Retained Earnings 和 Opening Balance Equity 合并为一个 `Equity:Opening-Balances` 账户。Beancount 会根据你的收入和费用账户计算当年损益，所以不需要结转单独的留存收益账户。

## 4. 在切换日开立总账

这家示例公司在 `2025-12-31` 有一份四行的试算平衡表。收入和费用行已经并入 Retained Earnings。QuickBooks Online 在新财年开始时也会自己这么做，详见 [View retained earnings account details](https://quickbooks.intuit.com/learn-support/en-us/help-article/financial-reports/view-retained-earnings-account-details/L7d6Ugx58_US_en_US)。

| 账户 | 借方 | 贷方 |
| --- | --- | --- |
| Checking | 12,450.00 | |
| Accounts Receivable (A/R) | 3,200.00 | |
| Visa credit card | | 1,875.40 |
| Retained Earnings | | 13,774.60 |
| **合计** | **15,650.00** | **15,650.00** |

把它保存为 `main.bean`：

```beancount
option "operating_currency" "USD"

2025-12-31 open Assets:Bank:Checking USD
2025-12-31 open Assets:AccountsReceivable USD
2025-12-31 open Liabilities:CreditCard:Visa USD
2025-12-31 open Equity:Opening-Balances USD

; Opening balances from the QuickBooks Trial Balance as of 2025-12-31
2025-12-31 pad Assets:Bank:Checking Equity:Opening-Balances
2025-12-31 pad Assets:AccountsReceivable Equity:Opening-Balances
2025-12-31 pad Liabilities:CreditCard:Visa Equity:Opening-Balances

2026-01-01 balance Assets:Bank:Checking 12450.00 USD
2026-01-01 balance Assets:AccountsReceivable 3200.00 USD
2026-01-01 balance Liabilities:CreditCard:Visa -1875.40 USD
2026-01-01 balance Equity:Opening-Balances -13774.60 USD
```

每一条 `pad` 要求 Beancount 插入使下一条 `balance` 断言成立的分录。每条 pad 的平衡方都进 `Equity:Opening-Balances`。`balance` 断言在其日期的开始时校验，所以 pad 的日期是切换日的前一天。

借方变成正数，贷方变成负数。这就是 Visa 的余额是 `-1875.40 USD` 的原因。

最后一行是对账。权益必须等于 `-13774.60 USD`，即 Retained Earnings 的贷方金额。如果某个资产或负债数字打错，被 pad 出来的权益就会改变，那条断言就会失败。

对于一家真实公司，为试算平衡表上的每一个资产负债表科目各加一条 `open`、一条 `pad` 和一条 `balance`。如果你按名称跟踪未结发票，把 A/R 和 A/P 按每个客户或供应商拆成一个子账户。

## 5. 引入历史数据

切换之后，新活动记录在 Beancount 里。银行和信用卡对账单是主要来源。在浏览器里用 [CSV 转 Beancount 转换器](/tools/csv-to-beancount)转换银行 CSV 导出，或用[银行导入指南](https://beancount.io/zh/docs/Solutions/import-bank-exports-cli)走命令行。

过去的年份是可选的。QuickBooks 总账导出没有一键导入。迁移那段历史需要脚本或手动映射：

1. 把 General Ledger 导出保存为 CSV。
2. 按日期和交易编号把它的行分组为交易。
3. 用第 3 步的映射重命名每个账户。
4. 把每一组写成一笔 Beancount 交易，其各分录之和为零。

如果你引入历史数据，就在那段历史的起点开立账户，而不是在切换日。然后保留 `2026-01-01` 的余额断言。它们证明转换后的历史数据到达的余额与 QuickBooks 报告的相同。

## 6. 对照 QuickBooks 校验

检查总账，然后列出所有余额：

```bash
bea --file main.bean check
bea --file main.bean query "SELECT account, sum(position) GROUP BY account ORDER BY account"
```

`bea check` 应报告没有错误。查询返回四行：`Assets:AccountsReceivable` 为 `3200.00 USD`，`Assets:Bank:Checking` 为 `12450.00 USD`，`Equity:Opening-Balances` 为 `-13774.60 USD`，`Liabilities:CreditCard:Visa` 为 `-1875.40 USD`。逐行与 QuickBooks 试算平衡表对比，贷方记为负数。

对命令行不熟？用 [CLI 快速上手](https://beancount.io/zh/docs/Basics/bea-cli)安装 `bea`。

## 7. 哪些东西不会迁移过来

账本迁移搬的是会计余额和历史数据。它不会搬 QuickBooks 围绕这些运作的业务功能：

- **发票和收款链接。** 未结发票保留为 A/R 余额。今后使用单独的开票服务。
- **工资（Payroll）。** 工资发放、税务表单和员工记录留在你的工资服务商那里。
- **销售税申报。** Beancount 记录负债。申报仍是一项单独的任务。
- **附件。** 收据和单据来自它们自己的 zip 导出，而不在报表里。
- **银行数据源规则和核对历史。** 把分类重建为导入规则。

对比页面说得很直白：不要抱着几个插件就能重建整个 QuickBooks 运营套件的假设去选 Beancount。当总账本身就是你长期的记录系统时，才选它。

在小企业里用 Beancount？请看[面向小企业的 Beancount.io](/for-small-business)，了解托管账本、银行同步和会计师协作。
