一步一步教你用Golang实现一个基于文件的待办事项(To-Do List)应用

答案是通过构建一个文件存储的待办事项应用快速上手Golang。该应用使用Go语言实现任务添加、标记完成、列表展示功能,数据保存为本地JSON文件,无需数据库,涵盖结构体定义、JSON编解码、文件读写与命令行解析等核心知识点,适合初学者掌握基础语法与实际项目结构。

一步一步教你用golang实现一个基于文件的待办事项(to-do list)应用

想快速上手 Golang?从一个简单实用的小项目开始是最佳选择。本文带你一步步用 Golang 实现一个基于文件的待办事项(To-Do List)应用。这个应用支持添加任务、标记完成、查看任务列表,并将数据保存在本地 JSON 文件中。不需要数据库,也不依赖外部框架,纯 Go 实现。

1. 项目结构设计

我们先规划项目的基本结构:

main.go:程序入口todo.go:定义任务结构和操作逻辑data/todos.json:存储任务数据的文件(自动创建)

在项目目录中创建这些文件和文件夹:

mkdir todo-app
cd todo-app
mkdir data
touch main.go todo.go
touch data/todos.json

2. 定义任务结构(todo.go)

打开 todo.go,我们先定义任务的结构体和一些基本方法。

立即学习“go语言免费学习笔记(深入)”;

package main

import “time”

// Task 表示一个待办事项type Task struct {ID int

json:"id"

Title string

json:"title"

Done bool

json:"done"

CreatedAt time.Time

json:"created_at"

}

接下来,定义一个结构体来管理任务列表:

// TaskList 管理所有任务type TaskList struct {Tasks []Task

json:"tasks"

}

添加一个方法来保存任务到 JSON 文件:

import (“encoding/json””os”)

const dataFile = “data/todos.json”

// Save 将任务列表保存到文件func (tl *TaskList) Save() error {data, err := json.MarshalIndent(tl, “”, ” “)if err != nil {return err}return os.WriteFile(dataFile, data, 0644)}

再添加一个方法从文件加载任务:

// LoadTaskList 从文件加载任务列表func LoadTaskList() (*TaskList, error) {tl := &TaskList{}data, err := os.ReadFile(dataFile)if err != nil {// 如果文件不存在,返回空列表if os.IsNotExist(err) {tl.Tasks = []Task{}return tl, nil}return nil, err}if len(data) == 0 {tl.Tasks = []Task{}return tl, nil}err = json.Unmarshal(data, tl)return tl, err}

3. 实现核心功能

在 todo.go 中添加添加任务和标记完成的方法。

// Add 添加新任务func (tl *TaskList) Add(title string) {newID := 1if len(tl.Tasks) > 0 {newID = tl.Tasks[len(tl.Tasks)-1].ID + 1}task := Task{ID: newID,Title: title,Done: false,CreatedAt: time.Now(),}tl.Tasks = append(tl.Tasks, task)}

// MarkDone 标记任务为完成func (tl *TaskList) MarkDone(id int) error {for i := range tl.Tasks {if tl.Tasks[i].ID == id {tl.Tasks[i].Done = truereturn nil}}return fmt.Errorf(“task with ID %d not found”, id)}

// PrintList 打印所有任务func (tl *TaskList) PrintList() {if len(tl.Tasks) == 0 {fmt.Println(“暂无任务”)return}for _, task := range tl.Tasks {status := “□”if task.Done {status = “✓”}fmt.Printf(“[%s] %d. %s (创建于 %s)n”,status,task.ID,task.Title,task.CreatedAt.Format(“2006-01-02”))}}

4. 编写主程序(main.go)

现在打开 main.go,实现命令行交互逻辑。

package main

import (“fmt””os””strconv””strings”)

在 main 函数中解析命令行参数:

func main() {args := os.Args[1:]if len(args) == 0 {showUsage()return}

// 加载任务列表taskList, err := LoadTaskList()if err != nil {    fmt.Fprintf(os.Stderr, "加载任务失败: %vn", err)    os.Exit(1)}cmd := args[0]switch cmd {case "add":    if len(args) < 2 {        fmt.Println("请提供任务内容")        return    }    title := strings.Join(args[1:], " ")    taskList.Add(title)    taskList.Save()    fmt.Printf("✅ 已添加任务: %sn", title)case "done":    if len(args) < 2 {        fmt.Println("请提供任务ID")        return    }    id, err := strconv.Atoi(args[1])    if err != nil {        fmt.Println("ID必须是数字")        return    }    err = taskList.MarkDone(id)    if err != nil {        fmt.Println(err)        return    }    taskList.Save()    fmt.Printf("✅ 已完成任务 ID: %dn", id)case "list":    taskList.PrintList()default:    showUsage()}

}

添加一个帮助提示函数:

func showUsage() {fmt.Println(“用法:”)fmt.Println(” todo add – 添加新任务”)fmt.Println(” todo done – 标记任务完成”)fmt.Println(” todo list – 查看所有任务”)}

5. 运行与测试

确保你已经初始化 Go 模块:

go mod init todo-app

现在可以运行应用了:

go run main.go add 学习Go语言基础
go run main.go add 完成待办事项项目
go run main.go list
go run main.go done 1
go run main.go list

每次操作后,data/todos.json 文件会自动更新,内容类似:

{ “tasks”: [ { “id”: 1, “title”: “学习Go语言基础”, “done”: true, “created_at”: “2025-04-05T10:00:00Z” }, { “id”: 2, “title”: “完成待办事项项目”, “done”: false, “created_at”: “2025-04-05T10:01:00Z” } ]}

基本上就这些。这个小应用展示了 Go 的结构体、JSON 编解码、文件读写和命令行处理等核心特性。你可以继续扩展它,比如支持删除任务、按状态过滤、或添加 Web 接口。不复杂但容易忽略的是错误处理和文件初始化逻辑,确保健壮性很重要。

以上就是一步一步教你用Golang实现一个基于文件的待办事项(To-Do List)应用的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1402571.html

赞 (0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
Golangdefer释放资源与错误处理结合实践
上一篇 2025年12月15日 18:49:16
Golang模块化开发与团队协作规范
下一篇 2025年12月15日 18:49:31

相关推荐

发表回复

登录后才能评论
关注微信