Fava 选项

可以通过在 Beancount 账本文件中使用 custom "fava-option" 指令来定制 Fava 的行为。这些指令允许你控制显示设置、导航、文件管理等——所有这些都无需离开你的纯文本复式记账工作流程。

语法

每个 Fava 选项都通过 Beancount 的 custom 指令设置：

YYYY-MM-DD custom "fava-option" "option-name" "value"

根据 Beancount 的语法，日期是必需的，但 Fava 会忽略它——你可以使用任何有效的日期。例如：

2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"

显示与本地化

`language`

设置 Fava 界面的语言。未设置时，Fava 将使用浏览器的首选语言。

默认值：null（从浏览器自动检测）
取值：任何有效的语言代码（例如："en"、"zh"、"de"、"fr"、"es"、"pt"、"ru"、"nl"）

2000-01-01 custom "fava-option" "language" "en"

`locale`

设置用于数字格式化（千分位分隔符、小数点）的区域设置。未设置时，将使用语言设置或浏览器区域设置。

默认值：null（使用 language 设置或浏览器区域设置）
取值：任何有效的区域设置字符串（例如："en_US"、"de_DE"、"zh_CN"）

2000-01-01 custom "fava-option" "locale" "en_US"

导航与布局

`default-page`

当你在未指定路径的情况下访问账本时，Fava 显示的页面。

默认值："income_statement/"
取值：任何有效的 Fava 页面路径

2000-01-01 custom "fava-option" "default-page" "balance_sheet/"

常见的页面路径包括："income_statement/"、"balance_sheet/"、"trial_balance/"、"journal/"、"holdings/"、"commodities/"、"editor/"。

`fiscal-year-end`

设置你的会计年度截止日期。这会影响 Fava 如何按会计年度而非日历年对数据进行分组。

默认值：12-31（12 月 31 日，日历年）
格式："MM-DD"

2000-01-01 custom "fava-option" "fiscal-year-end" "03-31"

此示例将会计年度设置为 3 月 31 日结束，这在英国、印度和日本的企业中很常见。

`indent`

自动格式化分录时使用的空格缩进数量。

默认值：2
取值：任何正整数

2000-01-01 custom "fava-option" "indent" "4"

`currency-column`

在编辑器中货币金额对齐的列位置。

默认值：61
取值：任何正整数

2000-01-01 custom "fava-option" "currency-column" "80"

内容可见性

`show-closed-accounts`

是否显示已使用 close 指令关闭的账户。

默认值：false
取值："true" 或 "false"

2000-01-01 custom "fava-option" "show-closed-accounts" "true"

`show-accounts-with-zero-transactions`

是否显示交易次数为零的账户。

默认值：true
取值："true" 或 "false"

2000-01-01 custom "fava-option" "show-accounts-with-zero-transactions" "false"

`show-accounts-with-zero-balance`

是否在报表中显示余额为零的账户。

默认值：true
取值："true" 或 "false"

2000-01-01 custom "fava-option" "show-accounts-with-zero-balance" "false"

`collapse-pattern`

用于指定在账户树中默认折叠的账户名称的正则表达式模式。你可以多次指定此选项以设置多个模式。

默认值：[]（无模式，不折叠任何内容）
取值：正则表达式字符串

2000-01-01 custom "fava-option" "collapse-pattern" "Assets:Investments:.*"
2000-01-01 custom "fava-option" "collapse-pattern" "Expenses:Food:.*"

`sidebar-show-queries`

在侧边栏中显示的已保存查询的数量。设置为 0 以完全隐藏查询。

默认值：5
取值：任何非负整数

2000-01-01 custom "fava-option" "sidebar-show-queries" "10"

文件管理

`default-file`

在使用编辑器时，新分录插入到的文件。如果未设置，Fava 将使用主账本文件。

默认值：null（主账本文件）
取值：Beancount 文件的路径

2000-01-01 custom "fava-option" "default-file" "/path/to/transactions.beancount"

`insert-entry`

一个正则表达式，用于控制新分录在文件中的插入位置。Fava 将在匹配此模式的第一行之前插入分录。

默认值：null
取值：正则表达式字符串

2000-01-01 custom "fava-option" "insert-entry" "^;; End of entries"

`auto-reload`

当检测到磁盘上的更改时，Fava 是否自动重新加载账本。

默认值：false
取值："true" 或 "false"

2000-01-01 custom "fava-option" "auto-reload" "true"

`use-external-editor`

是否使用外部编辑器而不是 Fava 内置的编辑器。启用后，源链接将在系统的默认编辑器中打开。

默认值：false
取值："true" 或 "false"

2000-01-01 custom "fava-option" "use-external-editor" "true"

### `import-config`

用于导入功能的 Beancount 导入配置文件路径。

- **默认值**：`null`
- **取值**：导入配置文件的路径

```bean
2000-01-01 custom "fava-option" "import-config" "/path/to/import-config.py"

`import-dirs`

扫描待导入文件的目录。可以多次指定。

默认值：[]
取值：目录路径

2000-01-01 custom "fava-option" "import-dirs" "/path/to/bank-downloads"

财务显示

`unrealized`

用于报告未实现收益和亏损的账户子类型。

默认值："Unrealized"
取值：任何有效的账户名称组成部分

2000-01-01 custom "fava-option" "unrealized" "Unrealized"

设置后，Fava 将使用诸如 Income:Unrealized 和 Expenses:Unrealized 的账户来记录未实现收益/亏损。

`invert-income-liabilities-equity`

是否反转收入、负债和权益类账户的符号。启用后，收入显示为正数，支出显示为负数，这符合一般习惯。

默认值：false
取值："true" 或 "false"

2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "true"

`conversion-currencies`

在报表中作为转换选项显示的货币。可以多次指定。

默认值：[]（使用运营货币）
取值：货币代码

2000-01-01 custom "fava-option" "conversion-currencies" "USD"
2000-01-01 custom "fava-option" "conversion-currencies" "EUR"

`account-journal-include-children`

账户流水页面是否应包含子账户的交易。

默认值：true
取值："true" 或 "false"

2000-01-01 custom "fava-option" "account-journal-include-children" "false"

监控

`uptodate-indicator-grey-lookback-days`

确定账户是否为“最新”时回溯的天数。在此期间内没有交易的账户将显示灰色指示灯。

默认值：60
取值：任何正整数（天数）

2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "90"

`upcoming-events`

显示未来多少天内即将发生的事件。

默认值：7
取值：任何非负整数（天数）

2000-01-01 custom "fava-option" "upcoming-events" "14"

查看当前选项

你可以通过导航到账本的设置页面，在 Beancount.io 控制面板中查看当前的 Fava 选项。“Fava 选项”部分显示所有配置的值，包括你尚未明确设置的任何选项的默认值。

另请参阅

选项配置 — Beancount 的核心 option 指令
UI 功能 — 自定义 Beancount.io 控制面板界面

Share on Twitter Follow @beancount_io

Fava 选项

语法

显示与本地化

`language`

`locale`

导航与布局

`default-page`

`fiscal-year-end`

`indent`

`currency-column`

内容可见性

`show-closed-accounts`

`show-accounts-with-zero-transactions`

`show-accounts-with-zero-balance`

`collapse-pattern`

`sidebar-show-queries`

文件管理

`default-file`

`insert-entry`

`auto-reload`

`use-external-editor`

`import-dirs`

财务显示

`unrealized`

`invert-income-liabilities-equity`

`conversion-currencies`

`account-journal-include-children`

监控

`uptodate-indicator-grey-lookback-days`

`upcoming-events`

推荐配置

查看当前选项

另请参阅

开启 Beancount.io 之旅

入门指南

功能特性

社区

法律合规

语法​

显示与本地化​

language​

locale​

导航与布局​

default-page​

fiscal-year-end​

indent​

currency-column​

内容可见性​

show-closed-accounts​

show-accounts-with-zero-transactions​

show-accounts-with-zero-balance​

collapse-pattern​

sidebar-show-queries​

文件管理​

default-file​

insert-entry​

auto-reload​

use-external-editor​

import-dirs​

财务显示​

unrealized​

invert-income-liabilities-equity​

conversion-currencies​

account-journal-include-children​

监控​

uptodate-indicator-grey-lookback-days​

upcoming-events​

推荐配置​

查看当前选项​

另请参阅​

开启 Beancount.io 之旅

入门指南

功能特性

社区

法律合规

语法

显示与本地化

`language`

`locale`

导航与布局

`default-page`

`fiscal-year-end`

`indent`

`currency-column`

内容可见性

`show-closed-accounts`

`show-accounts-with-zero-transactions`

`show-accounts-with-zero-balance`

`collapse-pattern`

`sidebar-show-queries`

文件管理

`default-file`

`insert-entry`

`auto-reload`

`use-external-editor`

`import-dirs`

财务显示

`unrealized`

`invert-income-liabilities-equity`

`conversion-currencies`

`account-journal-include-children`

监控

`uptodate-indicator-grey-lookback-days`

`upcoming-events`

推荐配置

查看当前选项

另请参阅