如何快速上手7days-golang:Go从零实现系列的完整环境与运行指南(新手必读)
7days-golang 是一个用 Go 语言 7 天从零实现的实战系列仓库,带你手写一个类似 gin 的 Web 框架 Gee、类似 groupcache 的 分布式缓存 GeeCache、ORM 框架 GeeORM、RPC 框架 GeeRPC,还附带 WebAssembly 示例与嵌入式数据库实践。本文是一份面向新手的完整环境与运行指南,帮你在 10 分钟内把整个仓库跑起来,边跑边学。
一、项目结构速览:4 大系列 + 2 个彩蛋
仓库按「系列/天数」组织,每一天都是一个独立可运行的 Go 模块,代码量小、依赖极少,非常适合逐日精读:
| 系列 | 目录 | 实现目标 | 对应文档 |
|---|---|---|---|
| 🌐 Web 框架 Gee | gee-web/ | 路由、Context、中间件、模板、Panic 恢复 | gee-web/doc/gee.md |
| ⚡ 分布式缓存 GeeCache | gee-cache/ | LRU、一致性哈希、SingleFlight、Protobuf | gee-cache/doc/geecache.md |
| 🗃️ ORM 框架 GeeORM | gee-orm/ | 对象映射、链式查询、事务、迁移 | gee-orm/doc/geeorm.md |
| 📞 RPC 框架 GeeRPC | gee-rpc/ | 消息编码、服务注册发现、负载均衡 | gee-rpc/doc/geerpc.md |
| 🪵 嵌入式数据库 gee-bolt | gee-bolt/ | 页面存储、内存映射、B+ 树 | — |
| 🎮 WebAssembly 示例 | demo-wasm/ | 浏览器端 Go 编译运行 | — |
每个系列内部都按 day1-xxx 到 day7-xxx 递进,例如 gee-web/day7-panic-recover/main.go 就是一个可直接运行的完整 Web 服务入口。
二、环境准备:3 个依赖即可开工
本系列所有模块的 go.mod 声明为 go 1.13,环境要求非常低:
- Go 语言:建议安装 Go 1.16 及以上版本(模块代理、CGO 支持更完善)。验证:
go version - gcc:GeeORM 依赖 SQLite 驱动(
github.com/mattn/go-sqlite3),它基于 CGO,编译时需要 gcc。Linux/macOS 一般自带,Windows 建议安装 MinGW。 - git:用于拉取仓库。
💡 小提示:如遇 CGO 报错,请确认
CGO_ENABLED=1且 gcc 在 PATH 中。
三、一键获取项目并验证环境
克隆仓库到本地(仓库只读,无需额外配置):
git clone https://gitcode.com/gh_mirrors/7d/7days-golang.git
cd 7days-golang
建议的学习顺序:先跑 Gee(最简单,纯标准库)→ 再跑 GeeRPC → 然后 GeeCache → 最后 GeeORM(需要 CGO)。
四、4 大系列运行指南(附命令)
4.1 运行 Gee:Go 从零实现的 Web 框架
以第七天(功能最完整)为例:
cd gee-web/day7-panic-recover
go run .
然后另开终端请求:
curl "http://localhost:9999" # 输出: Hello Geektutu
curl "http://localhost:9999/panic" # 触发 Panic 并验证自动恢复
可以看到日志中完整的路由注册与中间件执行轨迹,核心源码就在 gee-web/day7-panic-recover/gee/ 下,router.go、trie.go、recovery.go 各文件不到 200 行。
4.2 运行 GeeCache:Go 从零实现的分布式缓存
单节点演示直接运行对应天的目录即可;第五天起需要多节点协作,仓库已提供一键脚本 gee-cache/day5-multi-nodes/run.sh:
cd gee-cache/day5-multi-nodes
bash run.sh
脚本会自动编译并启动 3 个缓存节点(8001/8002/8003 端口)+ 1 个 API 网关(9999 端口),然后并发请求 http://localhost:9999/api?key=Tom,你可以观察到缓存如何按 key 经一致性哈希落到不同节点。
4.3 运行 GeeORM:Go 从零实现的 ORM 框架
GeeORM 以单元测试驱动开发,每个测试就是一个功能演示:
cd gee-orm/day7-migrate
go test -v geeorm/...
想一次性跑完整个系列的测试,可以直接用仓库自带的 gee-orm/run_test.sh,它会遍历 gee-orm/day*/ 目录逐个执行 go test。测试中会真实操作 SQLite 数据库,因此务必保证 gcc 可用。
4.4 运行 GeeRPC:Go 从零实现的 RPC 框架
第七天的示例在一个进程内同时启动注册中心、2 个服务节点和客户端,开箱即见负载均衡效果:
cd gee-rpc/day7-registry
go run ./main
输出中会看到多次 Foo.Sum 调用被随机分发到不同节点,以及广播调用时的超时处理日志,核心实现位于 gee-rpc/day7-registry/xclient/xclient.go 与 gee-rpc/day7-registry/registry/registry.go。
4.5 彩蛋:gee-bolt 与 WebAssembly 示例
- gee-bolt:从 gee-bolt/day1-pages/ 开始,用 7 天把内存中的树持久化到磁盘文件,是理解 B+ 树与 mmap 的绝佳材料,直接
go run对应目录即可。 - demo-wasm:demo-wasm/hello-world/ 用
GOOS=js GOARCH=wasm把 Go 编译成 WebAssembly 在浏览器运行,需要goexec工具(可用go install安装后按 demo-wasm/hello-world/Makefile 执行make)。
五、新手常见问题与排错清单
| 问题 | 原因与解法 |
|---|---|
go: updates to go.mod needed | 进入对应天目录后再执行 go mod tidy(在模块目录内操作,不要在整个仓库根目录执行) |
| SQLite 编译失败(gcc 报错) | GeeORM 需要 CGO:确认 CGO_ENABLED=1 并安装 gcc |
| 端口被占用(9999/8001 等) | lsof -i:9999 找到占用进程后关闭,或修改 main.go 中的端口 |
| 多天代码差异看不明白 | 每天目录都是独立快照,对比相邻两天的同名文件(如 day6 与 day7 的 peers.go)即可看到增量改动 |
六、总结:你的 7 天学习路线
- 第 1 周 Day 1:跑通
gee-web/day1-http-base,理解http.Handler接口; - 第 2-3 天:精读 Gee 的路由树与中间件(
gee-web/day3-router、gee-web/day5-middleware); - 第 4-5 天:上手 GeeCache,重点看一致性哈希 gee-cache/day4-consistent-hash/geecache/consistenthash/consistenthash.go;
- 第 6-7 天:用 GeeRPC 串起服务发现与负载均衡,最后用 GeeORM 补上数据库操作这一环。
整个仓库没有任何重型依赖,每天一个可运行的小目标,代码风格贴近生产级项目。照着本指南把四个系列依次跑通,你就已经亲手写出了 Web 框架、分布式缓存、ORM 和 RPC 框架的完整内核——这正是 7days-golang 想带给每一位 Go 学习者的成长体验。
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考








