go环境配置是硬性门槛，必须先确保go命令可用、go111module=on、goproxy正确，再执行go mod init初始化模块，最后按框架要求调用启动函数，缺一不可。
go 环境必须先配好，否则所有轻量级框架都跑不起来——这不是前置条件，是硬性门槛。
确认 go version 输出正常，再谈框架
go version 输出正常，再谈框架很多新手在跑 weebo、lumina 或 nagi 时卡在第一步：编译失败或 go run main.go 报 “command not found”。根本原因不是框架问题，而是 go 命令本身没进 PATH。
- Windows 用户装完
.msi后，务必重启终端（CMD/PowerShell），否则环境变量不生效 - macOS/Linux 用户若手动解压安装，检查
/usr/local/go/bin是否真在PATH里：echo $PATH | grep go
没输出？说明export PATH=$PATH:/usr/local/go/bin没生效，或写错了文件（比如改了~/.bash_profile却用zsh） - 验证命令是否可用：
which go
返回空？立刻回退检查安装步骤
别跳过这步。所有轻量框架都依赖 go build 和 go mod，它们不会帮你兜底。
go mod init 是轻量框架的启动开关
go mod init 是轻量框架的启动开关轻量框架（如 spatz、zagi、mie）几乎全部基于 Go Modules，不支持旧式 GOPATH 模式。
- 新建项目目录后，第一行必须是：
go mod init example.com/myapi
域名部分可以随意，但不能留空，也不能用main这类保留字 - 如果漏掉这步，
go get github.com/engageintellect/spatz会报错：go: go.mod file not found in current directory or any parent directory -
go.mod生成后，再go get框架才真正写入依赖；直接go run会因找不到模块而失败
注意：某些教程示例里省略了 go mod init，那是假定你已在模块上下文中——实际动手时，它永远是第一步。
选框架前，先看它依赖了几个外部包
轻量 ≠ 代码行数少，关键看编译后体积和运行时依赖。
-
weebo和mie核心只依赖net/http，go list -f '{{.Deps}}' . | wc -w输出通常 -
lumina明确声明“零外部依赖”，go mod graph里看不到第三方路径 -
nagi和zagi个别版本悄悄引入了github.com/mattn/go-colorable（仅用于开发日志着色），生产构建时可加-tags no_color剔除 - 反例：
spatz某些 v0.3.x 分支曾间接依赖golang.org/x/net，虽属官方子库，但会拖慢首次go mod download
判断方法很简单：克隆 demo 项目后执行
go mod graph | grep -v golang.org | grep -v google.golang.org如果还有输出，说明它不够“轻”。
go run main.go 跑不起来？先检查 main 函数签名
go run main.go 跑不起来？先检查 main 函数签名轻量框架通常要求你显式调用 ListenAndServe 或等效启动函数，不像 Gin 那样封装成 router.Run()。
常见错误：
- 忘记
log.Fatal(http.ListenAndServe(":8080", r))，程序启动即退出 - 把路由注册写在
init()里，但没导出处理器（例如写了func home()却没加http.HandlerFunc(home)） - 使用
lumina.New()后，误以为它自动监听，实际还需调用.Serve()方法
最简验证法：
package main
import (
"net/http"
"log"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
w.Write([]byte("ok"))
})
log.Fatal(http.ListenAndServe(":8080", nil))
}
能跑通，说明环境和基础 HTTP 能力没问题；再换框架，才能准确定位是框架配置问题还是环境问题。
真正的坑不在框架文档里，而在你本地 go env 的 GOPROXY 是否指向国内镜像、GO111MODULE 是否为 on、以及你有没有在错误的目录下执行 go run。这些细节比选哪个框架重要得多。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
