贝利信息

NEWS CENTER 新闻中心

Go初级项目实战适合做什么_Go新手入门项目推荐

日期：2026-01-18 00:00 / 作者：P粉602998670
上一篇 下一篇
todo CLI 是最适合 Go 新手的实战项目，它通过 flag、json、os 等标准库串联起结构体、错误处理、文件读写等核心技能，无需框架、数据库或部署即可构建真实可用的命令行工具。

todo CLI 是目前最适合 Go 新手的实战项目——它不依赖框架、不碰数据库、不搞部署，但能把 flag、json、os、time、结构体、错误处理、文件读写全串起来，跑起来就是个真能用的工具。

为什么选命令行待办工具而不是 HTTP server？

很多新手一上来就写 http.ListenAndServe，结果卡在路由设计、模板渲染、状态保持上，两周后只剩一个“能返回 Hello World”的空壳。而 todo 项目不同：

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)
}

注意点：

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