Gee-Web 学习笔记：语法卡点与框架闭环

这一阶段我在做 7days-golang 里的 Gee-Web 框架实战。相关教程是 Gee-Web 教程，代码在 7days-golang/gee-web，这次整理参考了我和 ChatGPT 的一段问答记录。

学习主线

我在 4 月底集中补了一段 Go 基础，又接着进入 Gee-Web。前面的问题还偏向语法层面，比如方法、指针、切片、字符串处理和测试命令。进入框架实战后，这些零散问题开始被放进一个完整请求链里理解。

Gee-Web 这条线对我最有帮助的地方，是它把 Web 框架的几个核心部件拆得足够小。路由、分组、中间件、上下文、模板渲染和错误恢复都能单独看清楚，又能在最后合成一条请求处理流程。学完以后，我对框架的理解离开了单纯调用 API 的层面，也能顺着源码解释请求为什么会走到某个 handler，公共逻辑为什么能被中间件统一处理，模板为什么能按名字渲染出来。

中间件和请求链

中间件是这次最容易串起全局理解的部分。日志、鉴权、异常恢复、限流这类能力，如果都写进业务 handler，代码会很快变得混乱。Gee-Web 的处理方式是把这些公共逻辑放进请求链，让业务 handler 保持简洁。

我现在理解中间件时，会先看它在请求进入和离开时分别做了什么，再看 Next 什么时候推进到下一个处理函数。这样看下来，中间件承担了函数包装和生命周期管理两层职责。

1
2
3
4
5
6
7

func Logger() HandlerFunc {
	return func(c *Context) {
		t := time.Now()
		c.Next()
		log.Printf("[%d] %s in %v", c.StatusCode, c.Req.RequestURI, time.Since(t))
	}
}

路由分组和嵌入

路由分组让我重新理解了 Go 里的嵌入。Engine 嵌入 *RouterGroup 后，可以直接调用 GET、POST 这些方法。这里依靠的是 Go 的方法提升机制，不能按类继承去理解。真正需要注意的是初始化。嵌入字段如果没有被正确赋值，调用方法时就可能遇到空指针问题。

路由分组后面的花括号也让我卡过。后来发现它只是普通代码块，用来把同一组路由放在一起，方便阅读。真正决定分组的是 Group 返回的对象，以及它内部保存的前缀。

1
2
3
4
5
6
7

r := gee.New()
v1 := r.Group("/v1")
{
	v1.GET("/", func(c *gee.Context) {
		c.HTML(http.StatusOK, "index.html", nil)
	})
}

可变参数和模板渲染

... 的用法是这次整理里另一个值得单独记下的点。它在函数定义处表示可变参数，在调用处表示切片展开。读 fmt.Sprintf(format, values...) 这类代码时，只要分清它出现的位置，理解成本会低很多。

1
2
3
4
5
6

func f(args ...string) {
	fmt.Println(args)
}

values := []string{"a", "b"}
f(values...)

模板渲染链路也在 Gee-Web 里变得清楚。先注册函数，再解析模板，最后按模板名执行。这里的模板名通常是文件名，也可以由模板里的 define 指定。以前我容易把模板路径和模板执行名混在一起，这次算是把两者分开了。

1
2
3
4

engine.SetFuncMap(template.FuncMap{
	"FormatAsDate": FormatAsDate,
})
engine.LoadHTMLGlob("templates/*")

语法点进入工程上下文

前几天留下的语法问题，在 Gee-Web 里都有了更具体的落点。[]byte(string) 会出现在响应写入和数据转换里，HasPrefix 会出现在路由匹配里，解引用赋值会出现在指针修改里，go test 则成了验证框架行为的基础工具。

这次我也补了一些 Go 工程常识。any 和 interface{} 等价，Go 1.18 以后 any 更常见。Go 没有传统函数重载，所以接口设计要更直接。runtime.Callers 可以拿到调用栈，在日志和错误定位里很有用。

阶段收获

Gee-Web 的完整实践让我建立了一个小型 Web 框架的轮廓。请求进来后，路由负责定位，分组负责组织前缀，中间件负责公共流程，上下文负责封装请求和响应，模板模块负责最终输出页面。每个模块都不复杂，组合起来就是框架的基本形态。

接下来我准备进入 learn-go-with-tests，用测试把 Go 的基础写得更稳。同时我也想从 Gee-Web 抽一个自己的最小框架模板，先保留路由、分组、中间件和模板渲染，再给每个模块补正常流程、边界流程和错误流程的测试。