Go 1.21+ 是 Web 开发合理起点，需验证版本、GOPATH/GOBIN 配置，用 go mod init 初始化模块，优先原生 net/http 实践再选框架，搭配 fresh 热重载与 curl/go tool trace 调试。
Go 1.21+ 是当前 Web 开发的合理起点，低于 1.19 的版本不建议用于新项目，尤其涉及 net/http 中间件、io/net 流处理或 embed 静态资源时会踩兼容性坑。
确认 Go 安装并验证 GOPATH 和 GOBIN 行为
Go 1.16+ 默认启用 GO111MODULE=on，不再依赖 GOPATH 存放源码，但 GOBIN 仍影响 go install 生成的可执行文件路径。常见错误是误以为 go run main.go 能自动加载本地 vendor/，其实它只认 go.mod 声明的依赖。
- 运行
go version确保输出类似go version go1.21.6 darwin/arm64 - 检查
go env GOPATH—— 即使不用它，也要知道默认值（如$HOME/go），避免和旧教程混淆 - 执行
go env GOBIN，若为空，go install会把二进制放到$GOPATH/bin；建议显式设为$HOME/.local/bin并加入$PATH
初始化模块并选择基础 Web 框架策略
用 net/http 原生写路由足够起步，过早引入 Gin/Echo 会掩盖 HTTP 处理本质，比如中间件执行顺序、http.ResponseWriter 写入限制、超时控制位置等。
- 在项目根目录运行
go mod init example.com/myweb，模块名不必真实可解析，但需符合域名格式 - 避免直接
go get github.com/gin-gonic/gin—— 先写一个main.go用http.HandleFunc启动服务，确认端口监听、静态文件、JSON 返回都通了再加框架 - 如果选 Gin，务必用
gin.Default()而非gin.New()，否则日志和恢复中间件不会自动注册，导致 panic 直接崩掉进程
配置开发期热重载与调试入口
Go 本身无内置热重载，靠外部工具补足；但别用 air 这类会自动重启整个进程的工具调试数据库连接或全局状态，容易掩盖初始化时机问题。
立即学习“go语言免费学习笔记（深入）”；
- 推荐
fresh（轻量）或gf（支持模板热编译），安装后用fresh -c fresh.conf启动，而非go run main.go - 在
main.go开头加log.SetFlags(log.LstdFlags | log.Lshortfile)，方便定位 handler 中的 panic 位置 - 调试 HTTP 请求时，优先用
curl -v http://localhost:8080/api/users而非浏览器，避免缓存干扰；同时打开go tool trace查看 goroutine 阻塞点（适用于并发逻辑复杂时）
真正卡住的往往不是“怎么装”，而是 go.mod 里间接依赖版本冲突、CGO_ENABLED=0 下 sqlite 驱动编译失败、或者用 os.OpenFile 读取模板却忘了设 os.O_RDONLY——这些细节比选框架更早出现，也更难排查。
