go web开发应从net/http标准库起步，先掌握http.handlefunc、http.servemux显式实例化、http.fileserver配合http.stripprefix处理静态文件、template.parseglob或embed模板加载等核心细节。
从 net/http 标准库起步，别急着装框架
Go Web 开发最不该跳过的起点就是标准库 net/http。它不是“玩具”，而是生产级服务器的底层支撑——Kubernetes、Docker 的很多 HTTP 服务都直接基于它构建。新手一上来就 go get github.com/gin-gonic/gin，容易把路由、中间件、上下文这些概念当成魔法，出问题时连日志在哪打、请求怎么卡住都摸不着头脑。
- 先写一个能跑通的
http.HandleFunc+http.ListenAndServe组合，哪怕只返回"Hello, World!" - 用
curl -v http://localhost:8080看原始请求/响应头，理解http.ResponseWriter是怎么写状态码和 body 的 - 别碰任何第三方模板引擎或 ORM——用
html/template渲染静态页面，用json.NewEncoder写 API，够用且暴露真实流程
http.ServeMux 和 nil 的区别，直接影响你后续加路由逻辑
初学代码里常见 http.ListenAndServe(":8080", nil)，这个 nil 表示用默认的全局 http.DefaultServeMux。它方便，但隐患明显：所有包里调用 http.HandleFunc 都会注册到同一个多路复用器上，一旦引入第三方库（比如某个监控埋点包悄悄注册了 /healthz），你的路由就可能被覆盖或冲突。
- 显式创建自己的
http.ServeMux实例：mux := http.NewServeMux()，再用mux.HandleFunc(...) - 后续要加中间件、静态文件服务、API 分组时，
mux可以作为子路由挂载点，结构更可控 - 避免全局状态污染，尤其在写测试时——你可以为每个测试新建独立
http.ServeMux，互不干扰
静态文件服务要用 http.FileServer + http.StripPrefix，否则路径永远 404
想让 /static/style.css 正确返回 CSS 文件？只写 http.Handle("/static/", http.FileServer(http.Dir("./static"))) 是错的。因为 FileServer 会把完整请求路径（如 /static/style.css）当作本地文件路径去查，结果找的是 ./static/static/style.css，自然 404。
- 必须配合
http.StripPrefix去掉前缀：http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static")))) -
StripPrefix不是装饰器，它会修改r.URL.Path后再交给FileServer，这是关键动作 - 如果静态资源放在项目根目录外（比如
../assets），注意http.Dir路径必须是绝对路径或相对于当前工作目录的正确相对路径，go run和go build启动时工作目录可能不同
模板渲染别用 template.ParseFiles 直接读相对路径
template.ParseFiles("../templates/index.html") 看似简洁，但运行时行为高度依赖当前工作目录（os.Getwd()）。你在 IDE 里点运行、终端里 go run main.go、或者编译后执行二进制，.. 指向的位置很可能不一样，模板加载失败还不报错，只默默返回空白页。
立即学习“go语言免费学习笔记（深入）”；
- 改用
template.ParseGlob("templates/*.html")，并确保templates/在可执行文件同级或嵌套目录中 - 更稳妥的做法：把模板文件 embed 进二进制（Go 1.16+）：
//go:embed templates/*+template.ParseFS(templatesFS, "templates/*.html") - 调试时加一行
log.Printf("template path: %s", filepath.Abs("templates/index.html"))，确认路径是否符合预期
真正卡住新手的往往不是语法，而是对 Go 的“默认行为”缺乏掌控——比如 nil 复用器的隐式共享、相对路径的运行时不确定性、HTTP 头未设导致浏览器缓存旧 JS。把这些细节抠清楚，比学十个框架都管用。
