GOROOT必须指向Go安装目录（如/usr/local/go），否则go build找不到标准库；GOPATH在GO111MODULE=off时决定依赖存放与二进制输出路径，设错会导致go mod init失败或go run报包未提供错误。
Go环境搭建本身不是目标，而是后续所有开发工作的起点。没搭对，后面写再多代码都可能卡在编译失败、调试断点不生效、依赖无法拉取这些基础问题上。
为什么 GOROOT 和 GOPATH 不能随便设？
这两个环境变量直接影响 Go 工具链能否定位标准库和你的项目代码。GOROOT 必须指向 Go 安装目录（比如 /usr/local/go），否则 go build 找不到 fmt、net/http 这些包；GOPATH 在 Go 1.11+ 虽然被模块机制弱化，但若仍启用 GO111MODULE=off，它就决定 go get 下载的包存哪、go install 的二进制放哪。
常见错误：GOPATH 设成项目根目录，结果 go mod init 失败或 go run . 报 “no required module provides package”。
go mod 初始化失败的三个高频原因
- 当前目录下存在
vendor文件夹且未清理，导致模块模式识别混乱 - 父目录已有
go.mod，而你试图在子目录再初始化——Go 默认沿路径向上找第一个go.mod，不会允许嵌套 - 网络策略拦截了
proxy.golang.org或goproxy.cn，表现为go mod download卡住或报connection refused
验证方式：运行 go env GOPROXY，确保返回值包含可用代理；手动执行 curl -v https://goproxy.cn 看是否能通。
VS Code 调试器启动失败，大概率是 dlv 没装对
Delve（dlv）不是安装完插件就自动可用的。必须显式执行：go install github.com/go-delve/delve/cmd/dlv@latest
然后确认 dlv version 能输出版本号。否则你在 launch.json 里配得再准，VS Code 也会弹出 “Failed to launch: could not find dlv”。
注意：dlv 需要与 Go 版本兼容——Go 1.21+ 推荐用 dlv@master 或最新 tagged 版，旧版 dlv 可能解析不了新的调试信息格式。
立即学习“go语言免费学习笔记（深入）”；
真正容易被忽略的是：环境变量和工具链版本的隐式耦合。比如你用 go install 装了新 dlv，但 shell 里 PATH 没刷新，或者用了 zsh 却在 .bashrc 里改了 GOROOT——这类问题不会报错，只会让命令行为“看起来正常却实际失效”。
