Golang新手练手项目有哪些_适合零基础的Go实战案例

新手练手应从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.OpenFilebufio.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.Splitmap[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 valueGET 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 run calculator.go --op mul --a 7 --b 6 并看到 42,比读十页并发文档都管用。