Go语言新手项目推荐与实战教程

对于刚接触Go语言的新手而言，从零开始构建一个真实可用的命令行待办工具（todo CLI）是最高效、最接地气的入门路径——它巧妙融合flag参数解析、JSON序列化、文件读写、错误处理、结构体设计等核心技能，全程无需框架、数据库或网络服务，每写一行代码都能立即通过go run验证效果；项目强调工程实践意识：如将loadTasks/saveTasks抽象为独立函数、用os.Stat安全判断文件存在性、善用flag替代原始os.Args实现健壮参数解析，并倡导“先手动验证再补测试”的务实节奏，让新手在解决真实问题的过程中自然掌握Go的简洁哲学与标准库精髓。

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、磁盘满。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。