go环境搭建关键在避开gopath与modules混用、ide中goroot/gopath错位及代理缺失三类陷阱：go 1.16+默认启用modules，gopath仅存go install工具；goroot须指向安装根目录（如/usr/local/go），非bin子目录；必须配置goproxy=https://goproxy.cn,direct以防go mod download卡死。
Go 环境搭建本身不追求“技巧”，而是要避开历史包袱和默认陷阱——尤其是 GOPATH 与 Go Modules 的混用、IDE 中 GOROOT/GOPATH 配置错位、以及代理缺失导致 go mod download 卡死这三类问题。
Go 1.16+ 不再需要手动配置 GOPATH
从 Go 1.16 开始，go mod 是默认启用的，GOPATH 仅用于存放 go install 安装的二进制工具（如 gopls、dlv），不再作为项目源码根目录。如果你还把项目放在 $GOPATH/src/xxx 下，反而会触发旧式查找逻辑，导致 go run 找不到模块或误报 cannot find package。
- 新建项目时，直接在任意路径执行
go mod init example.com/myapp，无需提前进入$GOPATH/src -
go env GOPATH输出的路径只影响go install的安装目标，不影响日常开发 - VS Code 或 GoLand 中若看到 “Project GOPATH” 设置项，留空或指向一个干净目录即可，不要强行匹配旧习惯
GOROOT 必须指向 Go 安装根目录，不是 bin 目录
常见错误是把 GOROOT 设成 /usr/local/go/bin 或 C:\Go\bin，结果 go build 报错：cannot find package "fmt"。这是因为 Go 工具链依赖 $GOROOT/src 和 $GOROOT/pkg，而 bin 下只有可执行文件。
- 正确值示例：
/usr/local/go（macOS/Linux）、C:\Go（Windows） - 验证方式：运行
go env GOROOT，然后检查该路径下是否存在src/fmt目录 - IDE 中配置 GOROOT 时，别依赖自动探测——某些插件会错误读取 PATH 中的
go可执行文件所在目录，漏掉上层
国内开发必须配 GOPROXY，否则 go mod tidy 会无限卡住
Go 默认代理 https://proxy.golang.org 在国内无法稳定访问，不设代理时 go mod download 会超时重试，表面看是“没反应”，实际在后台反复失败。
- 推荐设置：
go env -w GOPROXY=https://goproxy.cn,direct（支持私有模块回退到本地） - 验证是否生效：执行
go env GOPROXY，输出应含goproxy.cn；再运行go mod download rsc.io/quote，几秒内完成即正常 - 注意：某些企业网络会拦截 HTTPS 代理请求，此时需配合
NO_PROXY排除内网域名，例如go env -w NO_PROXY=.corp.example.com
真正拖慢效率的从来不是安装步骤本身，而是后续每次 go run 都因环境变量错位多等 10 秒、每个新项目都要手动删 vendor、或者 IDE 里跳转不到标准库源码——这些都源于初始配置没踩准关键点。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
