Go 本地待办清单 CLI

为什么从命令行待办清单开始

第一个项目最重要的不是功能多，而是能够完整走完一次工程闭环：先确认问题，再确定边界，然后编码、保存数据、处理错误、编写测试，最后构建出别人能运行的程序。

待办清单足够小，不需要注册账号、部署数据库或搭建前端；它又不是一道孤立算法题，因为数据需要跨进程保存，命令之间必须保持一致，异常输入也需要得到明确回应。

最终可以运行什么

完成全部章节后，你会得到一个名为 todo 的可执行程序：

todo add 学习 Go 文件操作
todo add 为项目编写测试
todo list
todo done 1
todo delete 2

它默认把数据保存在用户目录的 .xiaoai-todo/tasks.json，也允许通过 TODO_DATA_FILE 指定临时位置。这个小设计让日常使用保持简单，同时让自动化测试不会污染真实数据。

项目结构

examples/go-todo-cli/
├── main.go       # 读取环境并启动程序
├── app.go        # 命令解析与业务流程
├── task.go       # 任务模型和编号规则
├── store.go      # JSON 读取与安全替换
└── app_test.go   # 生命周期与异常测试

这里没有为了“像企业项目”而堆叠目录。拆分只服务于三个真实边界：用户输入、任务规则和数据存储。

推荐学习方式

先从第一章开始，不要一上来复制完整代码。每章只引入一个新问题，并在结尾给出可执行的检查方式。遇到结果不一致时，先停在当前章节定位，而不是带着错误继续向后。

完成第五章后，再打开仓库中的完整代码对照。你应该能够解释每个文件为什么存在、一个命令怎样流过系统，以及数据写入失败时程序会怎样表现。