17370845950

新手练手应从5分钟可运行、改代码即见效、错误信息直白的CLI到Web递进项目入手：go-simple-calculator（flag/运算/错误处理）、quiz-app-cli（CSV题库/终端交互/select+channel）、go-todo（CLI+HTTP双模式/内存存储/并发安全）、Godis简化版（Redis协议/TCP/RESP解析），重在建立程序生命周期感知。

Go 新手练手，**别一上来就啃 gin-vue-admin 或 go-zero**——那不是练手，是劝退。真正适合零基础的项目，得满足三个条件：能 5 分钟跑起来、改动一行代码立刻看到效果、出错时错误信息直白可查。下面这 5 个项目，按「从 CLI 到 Web」递进，全是实测过、新手踩坑最少的路径。

写完就能运行的 CLI 小工具：go-simple-calculator

这是最安全的起点。它只依赖标准库，不装任何第三方包，go run main.go --op add --a 3 --b 5 就输出 8。你不用纠结路由、数据库或 CORS，专注练：flag 解析、switch 运算逻辑、错误返回处理。

• 常见错误：把 flag.IntVar(&a, "a", 0, "") 写成 flag.Int("a", 0, "") → 返回的是 *int，后续无法直接参与运算
• 关键点：所有参数必须在 flag.Parse() 之后读取，否则值仍是零值
• 延伸建议：加一个 --history 参数，把每次计算结果追加写入 history.txt，顺手练 os.OpenFile 和 bufio.Writer

文件驱动的交互式练习：quiz-app-cli

它用 CSV 当题库，启动后逐题提问、计时、判分。好处是：数据和逻辑分离，你改题不用动代码；终端交互（fmt.Scanln + time.AfterFunc）比 Web 更直观；超时控制能让你第一次真正理解 select + channel 的协作方式。

• 容易卡住的地方：CSV 中中文字段乱码（Windows 默认 GBK）→ 用 golang.org/x/text/encoding/simplifiedchinese 转 UTF-8
• 性能注意：题目超过 100 行时，别用 csv.NewReader(file).ReadAll() 一次性加载，改用循环 Read() 防内存暴涨
• 实操建议：把 “单选” 改成 “多选”，要求用户输入类似 a,c,d，再用 strings.Split 和 map[string]bool 校验答案

轻量 HTTP 服务入门：go-todo（CLI + HTTP 双模式）

它用同一个数据结构（Todo struct）同时支持命令行增删查和 GET /todos 返回 JSON。这是你第一次把“内存数据”变成“可被 curl 访问的服务”，且不碰数据库——所有数据暂存 map[string]Todo。

• 典型报错：http: panic serving [::1]:xxxxx: runtime error: invalid memory address → 多半是没给 map 加 sync.RWMutex，并发读写崩了
• 为什么推荐它而不是纯 Gin 示例？因为它的 main.go 里明确区分了 if len(os.Args) > 1 { runCLI() } else { runHTTP() }，让你看清 CLI 和 Web 是两种启动路径
• 动手改一改：把内存存储换成 json.Marshal 写入 todos.json，每次启动时 ioutil.ReadFile 加载，你就完成了持久化第一步

协议级动手：从零解析 Redis 协议（Godis 简化版）

别被“Redis 实现”吓到。Godis 的教学版只实现 SET key value 和 GET key，核心就三件事：用 net.Listener 接 TCP 连接、按 Redis 的 RESP 协议解析 *3\r\n$3\r\nSET\r\n$3\r\nkey\r\n$5\r\nvalue\r\n、用 map[string]string 存值。没有 goroutine 泛滥，没有集群，只有协议和状态。

• 最容易忽略的细节：RESP 协议中字符串长度必须严格匹配，$3\r\nkey\r\n 少一个 \r\n 就卡死——用 bufio.Reader.ReadBytes('\n') 比 ReadString('\n') 更稳
• 调试技巧：用 telnet 127.0.0.1 6379 手动发指令，比写客户端更暴露协议问题
• 下一步自然延伸：加一个 TTL 字段，用 time.AfterFunc 触发删除，你就串起了并发、定时、内存管理

真正的难点不在语法，而在**对“程序生命周期”的感知**：CLI 工具执行完就退出，HTTP 服务要一直监听，TCP 服务器得处理连接断开和粘包。这些项目不是让你写出完美代码，而是让你亲手触发、观察、修复那些“程序不按你想的那样结束”的瞬间。跑通第一个 go ru

n calculator.go --op mul --a 7 --b 6 并看到 42，比读十页并发文档都管用。