Go工具链只需go命令就绪、gopls和dlv正确安装并加入PATH，即可满足95%日常开发；需验证go version（≥1.26.0）、GO111MODULE=on、GOPROXY=https://goproxy.cn,direct，并实操调试与测试流程。
Go 工具链不需要“堆砌”，只要 go 命令能跑、gopls 和 dlv 装对位置，就已满足 95% 的日常开发需求。其余工具（如 staticcheck）按需装，别盲目全量安装。
验证 go 基础命令是否就绪
这是整个链条的起点，不是“装完就完事”，而是要确认它在当前 shell 中真正可用、且行为符合现代 Go 模块规范：
- 运行
go version，输出必须是go1.22.x或更高（2026 年主流应为go1.26.0）； - 运行
go env GO111MODULE，结果必须是on—— 若为auto，说明旧项目残留配置干扰了全局行为，执行go env -w GO111MODULE=on强制覆盖； - 运行
go env GOPROXY，国内用户应看到类似https://goproxy.cn,direct，否则go mod download极大概率卡住； - 别依赖
which go就算完事，还要检查go env GOROOT是否指向你预期的安装路径（如/usr/local/go），避免和 Homebrew 或多版本管理器（如goenv）冲突。
只装这 4 个关键第三方工具
VS Code 的 Go 扩展首次打开 .go 文件时会弹窗提示“安装全部工具”，千万别点。很多已废弃（如 gocode、godef），装了反而导致 gopls 启动失败或补全错乱：
-
gopls：语言服务器，跳转、补全、诊断全靠它。安装命令：go install golang.org/x/tools/gopls@latest； -
dlv：调试器。命令：go install github.com/go-delve/delve/cmd/dlv@latest； -
gofumpt：比gofmt更严格的格式化器，推荐作为默认。命令：go install mvdan.cc/gofumpt@latest； -
staticcheck（可选）：CI 或本地make check用。命令：go install honnef.co/go/tools/cmd/staticcheck@latest； - 所有
go install安装的二进制都会落到$GOBIN（默认是$HOME/go/bin），确保该路径已加入PATH，否则编辑器或终端找不到它们。
初始化模块时绕开 GOPATH 路径陷阱
Go 1.22+ 已彻底弃用 $GOPATH/src 约束，但很多人仍习惯把项目建在 $GOPATH/src/xxx 下，结果出现 cannot find package 或 import path doesn’t contain a dot 报错：
立即学习“go语言免费学习笔记（深入）”；
- 新建任意目录，比如
~/projects/myapi，cd 进去； - 直接运行
go mod init myapi——myapi是模块路径，不是文件夹名，也不必带域名； - 若误用了
go mod init github.com/you/myapi，后续想改模块路径会牵扯所有import语句，不值得； - 别再手动设
GOPATH环境变量，除非你真要用go install把二进制装到$GOPATH/bin；现代项目用go run .或go build -o ./bin/app ./cmd/app更清晰； - 如果
go mod tidy报网络超时，先确认go env GOPROXY是否生效，再试go clean -modcache && go mod download清缓存重拉。
调试与测试流程必须实操验证一次
光看文档说“支持调试”没用，得亲手走通断点、变量查看、单步执行才算链路完整：
- 写一个最简
main.go（含fmt.Println("hello")）和对应main_test.go（含一个TestXxx函数）； - 终端执行
go test -v，确认测试通过； - 终端执行
dlv debug，启动后输入b main.main设断点，再c运行，看能否停住； - VS Code 中按
F5启动调试，检查左下角是否显示 “Debugging”、断点是否命中、Variables 面板能否展开查看局部变量； - 常见失败点：VS Code 的 Go 扩展未识别到
dlv（查 Output → Go 日志里有没有dlv not found）、dlv版本太老不兼容当前 Go（用dlv version核对）、或项目根目录下没有go.mod导致gopls无法加载项目上下文。
最容易被忽略的是模块代理和 GO111MODULE 的组合效果：它决定了 go get 是走模块模式还是退化回 GOPATH 模式。一旦 CI 环境和本地行为不一致，问题往往出在这里，而不是代码本身。
