Go 1.21+ 环境是否就绪，直接执行三行命令即可判断：go version 必须 ≥ go1.21；go env GOPATH 输出非空路径；go mod init example.com/api 能成功生成 go.mod 文件，失败则需执行 go env -w GO111MODULE=on。
Go 1.21+ 环境是否就绪，直接看这三行命令
不用查文档、不翻官网，执行完就知道环境能不能跑 RESTful 接口：
-
go version—— 必须 ≥go1.21（Gin v2.1+ 和 net/http 的 HTTP/2 支持依赖此版本） -
go env GOPATH—— 输出非空路径即可，现代 Go 已不强制依赖 GOPATH，但某些旧工具链仍会读取 -
go mod init example.com/api—— 能成功生成go.mod文件，说明模块系统可用；失败常见于未设GO111MODULE=on或当前目录含空格/中文
若第三步报 go: modules disabled by GO111MODULE=off，立刻执行：go env -w GO111MODULE=on。别跳过这步——Gin、gorilla/mux 等所有主流库都要求模块模式。
用 gin.Default() 启动服务前，先关掉调试干扰项
刚跑通 /ping 就以为环境 OK？别急。默认的 gin.Default() 会自动挂载 gin.Logger() 和 gin.Recovery()，看似友好，实则掩盖真实问题：
- 日志里混着颜色 ANSI 码，在 CI/终端复现困难，
curl -v http://localhost:8080/ping时响应头可能被截断 -
Recovery()捕获 panic 后只打日志不返回状态码，前端 fetch 一直 pending，你以为是网络卡，其实是 handler 崩了 - 调试接口时建议改用
gin.New()+ 手动注册中间件，例如仅保留日志：r.Use(gin.LoggerWithWriter(os.Stdout))
真正上线前再切回 Default()，开发期宁可多看几行错误栈，也不要被“静默失败”拖慢节奏。
立即学习“go语言免费学习笔记（深入）”；
在 Go 中使用 google/wire 实现编译时依赖注入——wire.NewSet、wire.Build、wire.Bind（接口→实现）、wire.Struct、wire.Value、wire.Interface
调试 RESTful 接口必须配好 curl 和 jq 组合技
别依赖 Postman 或浏览器地址栏——它们看不到原始响应头、无法控制 HTTP 方法语义、不能快速验证状态码边界。本地调试靠这三条命令闭环：
- 查路由是否注册成功：
curl -sI http://localhost:8080/users | head -n 1（看是否返回HTTP/1.1 200 OK，不是404） - 发 JSON POST 并格式化输出：
curl -X POST http://localhost:8080/users -H "Content-Type: application/json" -d '{"name":"test"}' | jq . - 模拟带路径参数的 GET：
curl "http://localhost:8080/users/123?fields=name,age"（注意 URL 中问号需引号包裹，否则 shell 会误解析）
如果 jq 报错 “Cannot parse”，说明后端没设 Content-Type: application/json 或返回了 HTML 错误页——这是 net/http 和 Gin 默认行为差异最常踩的坑：Gin 不设 header 也自动加，而原生 net/http 必须手动写 w.Header().Set("Content-Type", "application/json")。
路径参数和 query 参数别混用，c.Param() 和 c.Query() 行为完全不同
写 GET /users/:id 却用 c.Query("id") 取值？永远拿不到。Gin 的参数提取机制严格区分来源：
-
c.Param("id")只从路径模板匹配段取，如/users/123→"123"；若路由没定义:id，返回空字符串，不报错 -
c.Query("id")只从 URL query string 取，如/users?id=123→"123"；不存在时也返回空字符串 - 两者都返回
string，不做类型转换。想转成 int64？必须显式调用strconv.ParseInt(c.Param("id"), 10, 64)，且检查 error —— 否则/users/abc会 panic
最容易被忽略的是：路径参数不支持默认值或可选语法。想实现 /users（列表）和 /users/123（单条），必须注册两条独立路由，顺序不能错：/users/:id 必须放在 /users 之后，否则前者永远覆盖后者。
