Golang初学者如何做第一个小项目_Go语言入门实战完整流程

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 文件存，读写各三行代码，出错也容易定位。

容易踩的坑：用 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 那样隐形，需要你主动拆函数、显式传依赖。但这也正是它帮初学者建立清晰边界意识的地方。