Fava项目预算功能使用指南与版本变更解析

预算功能的核心定位

Fava作为Beancount的Web前端，其预算功能主要用于跟踪和比较实际支出与预算目标的差异。预算数据通过Beancount文件中的budget指令定义，在Fava界面中以可视化方式呈现。

预算查看方式详解

在Fava 1.30及以上版本中，预算查看主要通过以下两种途径：

1. 账户月度变化视图

   • 访问路径：导航至目标账户 → 选择"Changes (monthly)"视图
   • 典型示例：查看Expenses:Food账户时，URL格式为/account/Expenses:Food/?time=YEAR&r=changes
   • 显示内容：以表格形式展示每月预算金额与实际发生额的对比

2. 收入报表柱状图

   • 访问路径：通过Income Statement页面 → 选择对应账户节点
   • 可视化特点：用双色柱状图直观对比预算(通常为浅色)与实际支出(通常为深色)

版本升级注意事项

从旧版升级到Fava 1.30+版本后，用户需要注意：

1. 导航方式变化

   • 旧版侧边栏链接可能需要更新URL参数
   • 新版推荐使用自定义侧边栏链接：

     1970-01-01 custom "fava-sidebar-link" "预算视图" "/account/Expenses/?r=changes&conversion=USD"
     

2. 显示逻辑优化

   • 预算数据现在更集中显示在账户变化视图
   • 多币种处理需要指定预算货币(通过conversion参数)

最佳实践建议

1. 层级化预算查看

   • 查看顶级Expenses账户获取总预算概况
   • 逐级下钻到子账户分析具体类别

2. 跨期比较技巧

   • 在URL中添加time=2025参数锁定特定年份
   • 使用interval=year参数切换统计周期

3. 异常排查要点

   • 确认beancount文件中正确定义了budget指令
   • 检查是否所有涉及货币都已设置汇率转换
   • 验证侧边栏链接的URL参数是否与新版本兼容

技术实现原理

Fava的预算功能基于Beancount核心引擎的计算结果：

1. 解析budget指令定义的周期和金额
2. 按账户+时间段聚合实际交易数据
3. 在渲染时对两种数据进行对齐和可视化

对于开发者而言，预算数据的处理流程涉及：

• 前端：使用D3.js绘制对比图表
• 后端：通过beancount.query模块执行预算查询
• 数据传递：采用JSON格式交换预算和实际值数据