go version能正常输出即表示Go环境基本可用，需检查PATH配置；创建main.go并运行go run验证编译器、标准库与运行时连通；go mod init启用模块模式；go test -v执行内置测试；httptest.NewServer实现快速HTTP接口测试。
go version 能跑通就说明环境基本可用
安装完 Go 后第一件事不是写代码，而是验证 go version 是否能正常输出。如果报错 command not found: go，大概率是 PATH 没配对——Windows 安装 .msi 通常自动配置，Linux/macOS 手动解压后必须把 $GOROOT/bin 加进 shell 配置文件（如 ~/.zshrc），然后执行 source ~/.zshrc。
别急着初始化项目，先用最简方式验证：创建空目录，写个 main.go，内容只有一行 fmt.Println("ok")，然后运行 go run main.go。成功打印即表示编译器、标准库、运行时三者都连通了。
go mod init 是现代 Go 项目的起点
不用再纠结 GOPATH 目录结构。任意路径下执行 go mod init myapp 即可启用模块模式，生成 go.mod 文件。这一步会自动记录当前 Go 版本，并为后续依赖管理打基础。
- 模块名建议用有意义的域名或项目标识（如
github.com/yourname/myapp），避免纯短名，否则将来引入本地包或发布到私有仓库时容易冲突 - 如果项目已有旧版
GOPATH结构，go mod init仍可安全执行，Go 会自动扫描并导入已有依赖 - 执行后立即跑
go list -m all，确认模块名和版本是否符合预期；若显示main而非你指定的模块名，说明没在项目根目录执行命令
go test -v 能直接跑单元测试，无需额外框架
Go 的测试能力内建在工具链里，不需要装第三方测试库。只要满足两个条件：文件名以 _test.go 结尾，函数名以 Test 开头且参数为 *testing.T，go test 就能识别并执行。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
常见卡点：
- 测试文件和被测代码不在同一包（比如一个在
package main，另一个在package mypkg），会导致编译失败 —— 确保package声明一致 - 忘记加
-v参数，导致测试通过但无输出，误以为没跑起来 - 子测试用
t.Run时，内部逻辑没调用t.Fatal或t.Error，错误被静默吞掉 —— 建议每个断言后加简单日志，比如t.Log("got", got, "want", want)
httptest.NewServer 是 HTTP 接口测试最快路径
要测一个 HTTP handler，别急着起真实服务。用 httptest.NewServer 创建一个绑定到随机端口的临时服务器，它返回的 URL 可直接喂给客户端代码，全程不占端口、不依赖网络、秒级启动销毁。
注意几个实际细节：
- 必须调用
defer server.Close()，否则多次运行测试会累积 goroutine 泄漏 - handler 里用
http.HandlerFunc包一层更灵活，方便注入 mock 数据或模拟延迟（比如time.Sleep(100 * time.Millisecond)） - 如果被测逻辑依赖外部 API，就把那个 API 地址替换成
server.URL，而不是硬编码"http://localhost:8080"—— 这样才能保证并发测试不端口冲突
真正难的不是搭环境，而是让测试覆盖边界条件：空请求体、超长 header、非法 JSON、context timeout 触发……这些没法靠工具自动生成，得手动想清楚再写断言。
