Go环境仅能运行go run并不完备，还需完成模块初始化（go mod init需在正确项目根目录执行）、配置GOPROXY代理（推荐goproxy.cn,direct）、安装并配置工具链（gofmt、go vet、staticcheck等）三步。
Go 环境能跑 go run 就算搭好了？不，这离“高质量项目”还差三步：模块初始化、代理配置、工具链就位。缺一不可。
go mod init 必须在项目根目录执行
很多人在任意目录敲 go mod init，结果生成的 go.mod 里模块路径是 example.com/hello 这类占位符，后续 import 路径错乱、IDE 无法跳转、CI 构建失败都由此而起。
- 先
mkdir myapp && cd myapp，确保当前路径为空且是你真正的项目根目录 - 再运行
go mod init github.com/yourname/myapp（用你实际的 GitHub/GitLab 用户名和仓库名） - 如果项目将来要私有化，也建议用类似
gitlab.internal/myteam/myapp的格式，避免后期改 import 路径
不配 GOPROXY 的后果不只是慢
国内直连 proxy.golang.org 常超时或返回 403，但更隐蔽的问题是：go get 可能 silently fallback 到 git clone，而某些私有模块没开 HTTPS 或没配 SSH key，直接卡死在 “verifying …” 阶段，报错却只显示 no required module provides package，根本看不出是代理问题。
- 推荐配置：
go env -w GOPROXY=https://goproxy.cn,direct - 加
,direct是关键：对私有域名（如git.internal.company）自动绕过代理，不强制走 HTTPS - 若公司有内部 proxy，可替换为
https://your-proxy.example.com，但必须支持 Go proxy 协议
go install 工具链不是可选，而是质量门槛
写完代码用 go run 能跑，不代表项目可靠。缺少 gofmt、go vet、staticcheck 等工具，等于放弃基础代码质量门禁。
立即学习“go语言免费学习笔记（深入）”；
- 一次性装齐：
go install golang.org/x/tools/cmd/gofmt@latest、go install golang.org/x/tools/cmd/go vet@latest、go install honnef.co/go/tools/cmd/staticcheck@latest - 注意：这些命令安装的是二进制到
$GOBIN（默认$GOPATH/bin），必须确保该路径在$PATH中，否则 IDE 或 CI 找不到 - VS Code 的
go.toolsGopath设置必须和go env GOPATH一致，否则插件调用的gopls会找不到已安装工具
真正容易被忽略的不是“怎么装”，而是“谁在用”。go env 输出里的 GOPATH、GOROOT、GOBIN 三者路径是否被所有工具（shell、IDE、CI runner）一致读取——不同终端启动方式（GUI 点开 vs. terminal 里 exec）可能加载不同 shell 配置，导致 go version 成功但 go list -m all 失败。
