登录
首页 >  Golang >  Go教程

Golang编写CLI记账工具实战教程

时间：2026-05-19 18:54:22 465浏览 收藏

本文手把手教你用Golang标准库从零打造一个轻量、实用且可扩展的CLI记账工具——无需第三方框架，仅凭flag、encoding/json、os等内置包，就能实现账目添加、列表展示、收支筛选与余额统计等核心功能；通过Record结构体统一数据模型，JSON文件持久化确保数据不丢失，命令行子命令设计清晰直观，代码简洁易懂、逻辑扎实，是Go初学者练手和日常记账需求的理想实践方案。

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

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

以上就是《Golang编写CLI记账工具实战教程》的详细内容，更多关于golang,命令行工具的资料请关注golang学习网公众号！

golang 命令行工具
资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>