Go初学者应直接开发CLI待办工具，用flag包解析参数而非os.Args；为add/list等子命令创建独立FlagSet，用flag.String和flag.Arg(0)获取输入，Parse后检查flag.NArg()防漏参。
从零开始写一个命令行待办事项工具
Go 语言初学者不需要先啃完《Effective Go》再动手。第一个小项目建议直接做一个能跑起来、有输入输出、能存数据的 CLI 工具，比如 todo —— 它足够小，但覆盖了文件操作、结构体定义、命令行参数解析、基础测试等关键环节。
用 flag 解析命令行参数而不是自己切字符串
新手常直接用 os.Args 手动处理参数，结果很快遇到空格、引号、子命令等问题。Go 标准库的 flag 包已足够支撑初期需求，且语义清晰、自动报错友好。
常见错误现象：把 go run main.go add "buy milk" 中的引号当字面量，导致保存成 "buy milk"（带引号）；或没处理子命令优先级，todo list -v 被误认为是全局 flag。
- 用
flag.NewFlagSet为每个子命令（如add、list）单独建一组 flag，避免冲突 - 所有用户输入文本统一用
flag.String+flag.Arg(0)获取剩余非 flag 参数，不依赖Args()切片索引 - 在
flag.Parse()后立刻检查flag.NArg()，防止漏输必要参数
func main() {
addCmd := flag.NewFlagSet("add", flag.ContinueOnError)
title := addCmd.String("title", "", "task title")
if len(os.Args) < 2 {
fmt.Println("usage: todo [add|list]")
return
}
switch os.Args[1] {
case "add":
addCmd.Parse(os.Args[2:])
if addCmd.NArg() == 0 {
fmt.Println("error: missing task title")
return
}
saveTask(*title)
}
}
用 json.Marshal + os.WriteFile 做最简持久化
别一上来就接 SQLite 或 BoltDB。待办事项列表本质是数组，用 JSON 文件存，读写各三行代码，出错也容易定位。
立即学习“go语言免费学习笔记（深入）”；
容易踩的坑：用 os.OpenFile 配合 io.WriteString 追加写入，导致 JSON 格式损坏；或忘记在写入前调用 json.Unmarshal 读取旧数据再 append，结果每次只存一条。
- 每次写入前先
os.ReadFile整个文件 →json.Unmarshal成[]Task - 修改后调用
json.MarshalIndent格式化输出，方便人眼调试 - 用
os.WriteFile(filename, data, 0644)原子覆盖，避免中间状态损坏
注意：Windows 下路径分隔符不用硬写 \，直接用 filepath.Join("data", "tasks.json")。
用 go test 写第一个测试时必须绕开时间与文件系统
新手写的测试常直接调 saveTask("foo") 再读文件断言，结果测试污染真实数据、并行运行失败、CI 环境权限报错。
解决思路不是跳过测试，而是把依赖抽出来：
- 定义接口
type Store interface { Save([]Task) error; Load() ([]Task, error) } - 生产代码用
fileStore实现，测试时用内存版memStore（字段直接是[]Task） - 测试中不碰磁盘，也不依赖
time.Now()—— 把创建时间作为参数传入NewTask(title, time.Time)
这样第一份测试代码才能稳定跑通，建立正向反馈。否则“测试写完就挂”，人就放弃了。
复杂点在于，Go 的接口抽象不像 Python 那样隐形，需要你主动拆函数、显式传依赖。但这也正是它帮初学者建立清晰边界意识的地方。
