如何用 Golang 编写一个命令行记账工具_Golang CLI 账本程序实战讲解_技术教程

答案是使用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，便于持久化和人工查看。

文件读写与数据持久化

程序启动时从文件加载账目列表，退出前写回。使用 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 或 exp

ense")
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 float64
for _, 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 记账工具就完成了。不复杂但容易忽略的是错误处理和时间格式统一，实际使用中建议加上。