go环境配置失败主因是go命令未加入path；api测试失败多因未关闭http.listenandserve或缺失content-type头；需验证go version、正确配置path、避免gopath/src陷阱、用httptest.newrecorder单元测试、gock拦截第三方api并清理。
Go 环境装不上，90% 是 go 命令没进 PATH；API 测试跑不起来，80% 是用了 http.ListenAndServe 却没关 server，或测试里漏了 Content-Type 头。
验证 go 命令是否真可用
别只信安装器勾选的“添加到 PATH”——它常失效。终端里直接敲：
go version
如果报 command not found，说明路径没生效：
- macOS/Linux：运行
which go，没输出就去 ~/.zshrc 或 ~/.bash_profile 里加一行export PATH=$PATH:/usr/local/go/bin（或你实际的安装路径），再source ~/.zshrc - Windows：PowerShell 里执行
Get-Command go，失败就去「系统属性 → 高级 → 环境变量」手动把C:\Program Files\Go\bin（或你装的路径）加进用户或系统PATH - 装完后必须新开终端——旧终端不会自动继承新环境变量
初始化项目时避开 vendor 和 GOPATH/src 陷阱
go mod init 在错误目录下会静默失败或生成错乱的 module 名：
- 先确认当前目录不在
$GOPATH/src下（比如~/go/src/xxx）——进去就删掉vendor/目录，再cd ..切出来 - 运行
go env -w GO111MODULE=on强制启用模块模式（Go 1.16+ 默认开，但 CI 脚本可能关着） - 删掉项目根目录下的
vendor/（除非你明确要 vendor 依赖） - 然后在干净目录下执行
go mod init example.com/api-test
用 httptest.NewRecorder 写单元级 API 测试
不用起真实服务、不占端口、秒级完成——这才是本地验证接口逻辑的正确姿势：
- handler 函数必须接收
*http.Request，不能传nil，否则r.URL.Query()会 panic - 构造请求时记得设头：
req.Header.Set("Content-Type", "application/json")，否则很多 handler 直接返回 415 - POST JSON 用
strings.NewReader(`{"id":1}`)做 Body，别用字符串拼接 - 响应体别用
io.ReadAll+string()，直接json.Unmarshal(resp.Body.Bytes(), &out)解析到结构体 - 测试完别忘断言状态码：
if resp.Code != http.StatusOK { t.Fatal("expected 200") }
用 gock 拦截第三方 API 调用
你的接口依赖 https://api.example.com/users？别让测试连线上环境：
- 先
go get -u gopkg.in/h2non/gock.v1 - 测试开头加
gock.EnableNetworking()（允许未 mock 的请求走真实网络，方便调试） - mock 时写：
gock.New("https://api.example.com").Get("/users").Reply(200).JSON(map[string][]string{"data": {"a", "b"}}) - 测试末尾必须
gock.Off()清理，否则后续测试会被污染 - 注意：
gock只拦截http.DefaultClient发出的请求；如果你用了自定义 client，得显式传给gock注册
真正卡住人的不是语法，而是 go 命令找不到、go mod init 在 GOPATH/src 下静默失败、测试里忘了 req.Header.Set 或漏掉 gock.Off() —— 这些点不盯住，写再多 handler 也白搭。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
