todo CLI 是最适合 Go 新手的实战项目，它通过 flag、json、os 等标准库串联起结构体、错误处理、文件读写等核心技能，无需框架、数据库或部署即可构建真实可用的命令行工具。
todo CLI 是目前最适合 Go 新手的实战项目——它不依赖框架、不碰数据库、不搞部署，但能把 flag、json、os、time、结构体、错误处理、文件读写全串起来，跑起来就是个真能用的工具。
为什么选命令行待办工具而不是 HTTP server？
很多新手一上来就写 http.ListenAndServe，结果卡在路由设计、模板渲染、状态保持上，两周后只剩一个“能返回 Hello World”的空壳。而 todo 项目不同：
- 输入输出明确：
todo add "买咖啡"→ 写入 JSON；todo list→ 读 JSON 并格式化打印 - 无外部依赖：不用配数据库、不用起服务、不涉及 CORS 或 HTTPS
- 错误反馈直接：文件打不开就报
open tasks.json: no such file or directory，一眼定位问题 - 可立即验证：每加一行逻辑，都能用
go run main.go立刻看到效果
loadTasks 和 saveTasks 必须拆成独立函数
新手常把所有逻辑堆在 main 里，导致后续加 done 或 rm 时反复复制粘贴文件操作代码。正确做法是提前抽象出两个核心函数：
const dataFile = "tasks.json"func loadTasks() ([]Task, error) { if _, err := os.Stat(dataFile); errors.Is(err, os.ErrNotExist) { return []Task{}, nil } f, err := os.Open(dataFile) if err != nil { return nil, err } defer f.Close() var tasks []Task return tasks, json.NewDecoder(f).Decode(&tasks) }
func saveTasks(tasks []Task) error { f, err := os.Create(dataFile) if err != nil { return err } defer f.Close() return json.NewEncoder(f).Encode(tasks) }
注意点：
-
os.Stat判断文件是否存在，比直接os.Open后检查os.IsNotExist更安全（避免竞态） - 必须
defer f.Close()，否则多次运行后可能遇到too many open files -
json.Encoder比json.Marshal + os.WriteFile更省内存，尤其任务多时
用 flag 替代 os.Args 才算真正入门
初期用 os.Args[1] 快速验证命令分发没问题，但很快会撞墙：比如 todo add -p "高优先级" "写文档" 怎么解析？这时候必须升级到标准库 flag：
func main() {
addCmd := flag.NewFlagSet("add", flag.Continue)
title := addCmd.String("title", "", "任务标题（必填）")
listCmd := flag.NewFlagSet("list", flag.Continue)
doneCmd := flag.NewFlagSet("done", flag.Continue)
id := doneCmd.Int("id", 0, "任务 ID（必填）")
if len(os.Args) < 2 {
fmt.Println("用法: todo [add|list|done|rm]")
return
}
switch os.Args[1] {
case "add":
addCmd.Parse(os.Args[2:])
if *title == "" {
fmt.Println("错误：-title 参数不能为空")
return
}
// ...
case "done":
doneCmd.Parse(os.Args[2:])
if *id == 0 {
fmt.Println("错误：-id 参数必须大于 0")
return
}
// ...
}}
关键好处：
- 自动处理
-h/--help输出 - 类型安全：
flag.Int直接转成int，不用自己strconv.Atoi - 参数顺序无关：
todo add -title "开会" -p high和todo add -p high -title "开会"都行
别急着加测试，先让 saveTasks 能被手动验证
新手容易陷入“先写 test 再写实现”的误区，结果花半天配 testify，却连 tasks.json 是否写对都懒得打开看一眼。更务实的做法是：
- 每次调用
saveTasks后，立刻用cat tasks.json看内容是否合法 JSON - 故意删掉
tasks.json，再运行todo list，确认返回空列表而非 panic - 用
todo add "a" && todo add "b" && todo list连续执行，观察 ID 是否自增（靠len(tasks)+1实现即可）
等这些手动流程跑顺了，再补 TestLoadTasks 和 TestSaveTasks —— 此时你才知道哪些边界 case 真的要测，比如空文件、非法 JSON、磁盘满。
