只需设置goroot、gobin、path三个核心环境变量即可启动go开发；goroot指向go安装目录，gobin建议设为$goroot/bin，path必须包含$goroot/bin；gopath在go 1.16+ module模式下非必需。
go run 直接报错、go mod init 找不到模块、GOROOT 和 GOBIN 冲突导致命令行找不到可执行文件——这些不是配置问题，是根本没跑通最基础的“能用”门槛。
Go 环境变量到底该设哪些？
只设三个核心变量就足够启动开发：GOROOT、GOBIN、PATH。其他如 GOPATH 在 Go 1.16+ 已非必需（Module 模式下可完全忽略），强行设置反而容易和 go mod 行为冲突。
-
GOROOT：指向 Go 安装根目录（例如/usr/local/go或C:\Program Files\Go），必须准确，否则go version都可能失败 -
GOBIN：建议显式设为$GOROOT/bin（Linux/macOS）或%GOROOT%\bin（Windows），避免和用户级bin混淆 -
PATH：必须包含$GOROOT/bin，否则终端不认识go命令；若还加了$GOBIN，注意别重复添加
验证方式：运行 go env GOROOT 和 go env GOPATH，前者应输出你设的路径，后者在 Module 项目里可以为空或默认值，不用硬改。
go mod init 报错 “unknown revision” 怎么办？
这不是网络问题，而是本地 Git 配置或代理干扰了模块解析。Go 的模块下载依赖 git 命令行为，但默认会走系统 Git 配置，比如你全局设了 git config --global http.proxy，而某些私有仓库又不走代理，就会卡在 “unknown revision”。
- 先检查是否真连得上：运行
git ls-remote -q https://github.com/golang/net，看能否列出 ref - 临时禁用 Git 代理：
git config --global --unset http.proxy（之后可按需恢复） - 更稳妥的做法是让 Go 绕过 Git：设置
GOPROXY=https://proxy.golang.org,direct，国内加https://goproxy.cn - 如果用私有模块，还需配
GOINSECURE或GOPRIVATE，否则会强制走 proxy 导致 403
为什么 go run 能跑，go build 却提示 “cannot find module”？
根本原因是当前目录不在任何已初始化的 Module 内，go run 会降级为“单文件模式”直接编译执行，而 go build 默认要求 Module 上下文。
- 运行
go mod init example.com/myapp创建go.mod文件，哪怕只是临时命名 - 确认当前路径下有
go.mod，且go list -m能输出模块名 - 不要在
$GOPATH/src下手动建目录再go mod init——旧式 GOPATH 结构和新 Module 混用极易触发路径解析歧义 - 如果只是想快速编译单文件，用
go build main.go（显式指定文件），而非go build（隐式找当前 module）
GOROOT 会让 go 命令本身失效；一个多余的 GOPATH 会让 go mod 误判项目位置；一次代理配置残留会让整个模块拉取链静默中断。这些点不手动验证，光看教程步骤等于没搭。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
