答案是使用Golang标准库实现一个简洁的CLI记账工具,通过Record结构体存储账目,JSON文件持久化数据,flag解析命令行参数,支持添加、列出、统计功能,程序启动时加载ledger.json,退出时保存,用os.Args判断子命令,add命令添加带ID和时间的记录,list显示所有条目,balance计算收入与支出差额,核心逻辑清晰可扩展。

用 Golang 写一个命令行记账工具,核心是简洁、实用、可扩展。我们不依赖复杂框架,只用标准库就能快速实现一个支持记录收支、查询账目、统计汇总的 CLI 账本程序。
功能设计与数据结构
先明确这个工具的基本功能:
- 添加一笔账目(金额、类型、备注)
- 列出所有账目
- 按条件筛选(如支出/收入)
- 显示当前余额
每条账目信息可以用结构体表示:
type Record struct {ID int `json:"id"`
Amount float64 `json:"amount"`
Type string `json:"type"` // income / expense
Note string `json:"note"`
Time string `json:"time"`
}
账本数据可以保存在本地 JSON 文件中,比如 ledger.json,便于持久化和人工查看。
立即学习“go语言免费学习笔记(深入)”;
文件读写与数据持久化
程序启动时从文件加载账目列表,退出前写回。使用 encoding/json 处理序列化。
读取账本示例:
func loadRecords() ([]Record, error) {file, err := os.Open("ledger.json")
if err != nil {
if os.IsNotExist(err) {
return []Record{}, nil
}
return nil, err
}
defer file.Close()
var records []Record
json.NewDecoder(file).Decode(&records)
return records, nil
}
保存账本也很直接:
func saveRecords(records []Record) error {file, err := os.Create("ledger.json")
if err != nil {
return err
}
defer file.Close()
return json.NewEncoder(file).Encode(records)
}
命令行参数解析
使用标准库 os.Args 或更清晰的 flag 包处理用户输入。
例如支持以下命令:
- add -amount=100 -type=income -note="工资"
- list
- balance
用 flag 实现 add 命令:
var addCmd = flag.NewFlagSet("add", flag.ExitOnError)var addAmount = addCmd.Float64("amount", 0, "金额")
var addType = addCmd.String("type", "expense", "类型: income 或 expense")
var addNote = addCmd.String("note", "", "备注")
主函数中判断子命令:
if len(os.Args) fmt.Println("用法: ledger [add|list|balance]")os.Exit(1)
}
switch os.Args[1] {
case "add":
addCmd.Parse(os.Args[2:])
// 添加逻辑
case "list":
// 列出所有
case "balance":
// 计算余额
}
核心功能实现
添加一条记录:
records, _ := loadRecords()newID := 1
if len(records) > 0 {
newID = records[len(records)-1].ID + 1
}
record := Record{
ID: newID,
Amount: *addAmount,
Type: *addType,
Note: *addNote,
Time: time.Now().Format("2006-01-02 15:04"),
}
records = append(records, record)
saveRecords(records)
计算余额只需遍历:
var income, expense float64for _, r := range records {
if r.Type == "income" {
income += r.Amount
} else {
expense += r.Amount
}
}
fmt.Printf("收入: %.2f\n支出: %.2f\n余额: %.2f\n", income, expense, income-expense)
基本上就这些。通过结构体定义数据,JSON 持久化,flag 解析命令,再加几个函数完成增查统,一个轻量高效的 CLI 记账工具就完成了。不复杂但容易忽略的是错误处理和时间格式统一,实际使用中建议加上。










