Fava 的行为可以通过在 Beancount 账本文件中使用 custom "fava-option" 指令来自定义。这些指令允许你控制显示设置、导航、文件管理等——无需离开纯文本会计工作流程。
语法
每个 Fava 选项都通过 Beancount 的 custom 指令设置：
YYYY-MM-DD custom "fava-option" "选项名称" "值"日期是 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 - 值：导入配置文件的路径
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"推荐配置
对于大多数用户，以下 Fava 选项提供了一个良好的起点：
; 显示设置
2000-01-01 custom "fava-option" "language" "en"
2000-01-01 custom "fava-option" "default-page" "income_statement/"
; 布局
2000-01-01 custom "fava-option" "indent" "2"
2000-01-01 custom "fava-option" "currency-column" "61"
; 内容可见性
2000-01-01 custom "fava-option" "show-closed-accounts" "false"
2000-01-01 custom "fava-option" "sidebar-show-queries" "5"
; 财务显示
2000-01-01 custom "fava-option" "invert-income-liabilities-equity" "false"
; 监控
2000-01-01 custom "fava-option" "upcoming-events" "7"
2000-01-01 custom "fava-option" "uptodate-indicator-grey-lookback-days" "60"查看当前选项
你可以通过导航到账本的设置页面，在 Beancount.io 仪表盘 中查看当前的 Fava 选项。“Fava 选项”部分显示所有已配置的值，包括任何你未显式设置的选项的默认值。