Go标准库net/http可10分钟跑起HTTP接口；需先确认环境就绪（go mod init）、用http.HandleFunc注册路由、http.ListenAndServe启动服务，支持JSON响应与参数解析，无需第三方框架。
直接上手就行，不用等“学完语法再写后端”——Go 的标准库 net/http 足够你 10 分钟跑起一个可访问的 HTTP 接口，这才是真实开发起点。
先验证 Go 环境是否真能跑起来
很多新手卡在第一步：明明装了 Go，go version 有输出，但 go run main.go 报错找不到命令或模块。这不是代码问题，是环境没真正就绪。
- 必须确认
GOROOT和GOPATH不需要手动设（Go 1.16+ 默认启用 modules，且GOROOT由安装程序自动配置）； - 检查终端里执行
which go（macOS/Linux）或where go（Windows），确保调用的是你刚装的版本，不是旧版或别处残留的； - 新建空文件夹，进目录后立刻执行
go mod init example.com/hello，生成go.mod—— 没这一步，go run在新项目里会拒绝运行（报go: cannot find main module）。
用 net/http 写第一个接口，不装任何第三方库
别急着 go get github.com/gin-gonic/gin。标准库的 http.ListenAndServe 已经能处理路由、JSON 返回、端口绑定，足够验证逻辑和调试流程。
- 在项目根目录建
main.go，写入以下内容：package main import ( "encoding/json" "log" "net/http" ) func handler(w http.ResponseWriter, r *http.Request) { w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(map[string]string{ "status": "ok", "msg": "Hello from net/http", }) } func main() { http.HandleFunc("/", handler) log.Println("Server starting on :8080") log.Fatal(http.ListenAndServe(":8080", nil)) } - 关键点：
http.HandleFunc注册路由，json.NewEncoder(w).Encode(...)直接写响应体，不用拼字符串； - 运行
go run main.go，然后浏览器打开http://localhost:8080或用curl http://localhost:8080，看到 JSON 就算通了； - 常见坑：
log.Fatal会让进程退出，开发时建议换成log.Printf+ 手动os.Exit(1)，方便调试时不反复重启。
加路由和参数解析，别碰框架前先搞懂请求生命周期
新手容易把“路由”当成黑盒。用标准库手动拆解一次，比直接用 gin.GET("/user/:id") 理解得深得多。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- Go 的
http.Request.URL.Query()读 query 参数，r.URL.Path拿路径，r.Method判断方法 —— 这些就是所有 Web 框架底层都在干的事； - 示例：支持
/user?id=123和/user/123两种写法：func userHandler(w http.ResponseWriter, r *http.Request) { if r.Method != "GET" { http.Error(w, "Method not allowed", http.StatusMethodNotAllowed) return } // 解析 /user?id=123 id := r.URL.Query().Get("id") if id == "" { // 尝试解析 /user/123 parts := strings.Split(r.URL.Path, "/") if len(parts) > 2 { id = parts[2] } } if id == "" { http.Error(w, "ID required", http.StatusBadRequest) return } w.Header().Set("Content-Type", "application/json") json.NewEncoder(w).Encode(map[string]string{"id": id}) } - 注意导入
"strings"；http.Error是标准错误响应方式，比自己写状态码 + body 更安全； - 这个阶段不追求“优雅”，而要确认你能控制 URL 怎么拆、参数怎么取、错误怎么返回 —— 后续换 Gin 或 Echo，只是把这些逻辑封装成更短的写法而已。
什么时候该引入 Gin？看三个信号
Gin 不是“进阶才用”，而是当你开始被重复代码拖慢节奏时才值得切过去。别为了“用新技术”而提前引入。
- 信号一：路由超过 5 个，每个都要写
if r.URL.Path == ...+ 方法判断，switch r.Method嵌套三层以上； - 信号二：需要统一加日志、CORS、JWT 验证，但每次都在 handler 开头复制粘贴相同逻辑；
- 信号三：想返回结构体自动转 JSON，但每次都要手动
json.NewEncoder(w).Encode(...)，还总忘设Content-Type； - 这时执行
go get github.com/gin-gonic/gin，改写入口：func main() { r := gin.Default() r.GET("/user/:id", func(c *gin.Context) { id := c.Param("id") c.JSON(200, gin.H{"id": id}) }) r.Run(":8080") }——你会发现，之前手动处理的路径提取、JSON 序列化、Header 设置，全被收编了。
真正的门槛不在语法，而在你能否分辨“这是标准库能搞定的”，还是“该让框架接管重复劳动了”。多数人卡住，是因为过早跳进框架源码，却没亲手写过一遍它封装掉的东西。
