go语言环境搭建需手动配置goroot、gopath和path三处变量，解压官方包后须明确设置goroot指向根目录、gopath自定义工作区，并将二者bin路径均加入path，再通过go mod init和go get验证工具链完整性。
Go 语言环境搭建本身不复杂，但多数人卡在 PATH 配置错误、GOROOT 与 GOBIN 混用、或误信“一键安装包自动搞定一切”上——实际上，手动配好这三处变量，比任何图形化安装器都可靠。
确认系统是否已存在冲突的 Go 安装
很多问题其实源于旧版本残留。Mac 或 Linux 上执行：which go，Windows 上运行：where go。如果返回路径（比如 /usr/local/go/bin/go 或 C:\Go\bin\go.exe），说明已有安装，别急着覆盖。
- 先运行
go version看当前版本；若低于 1.20，建议卸载干净再重装 - 检查
echo $PATH（Mac/Linux）或echo %PATH%（Windows），确认没有多个bin目录重复包含go - 尤其注意 VS Code 的 Remote-WSL 或 Docker 容器内是否继承了宿主机错误的
PATH，那会导致终端能跑、IDE 报错
下载与解压后必须手动设置 GOROOT 和 GOPATH
官方二进制包（.tar.gz 或 .zip）解压即用，但不会自动写入环境变量——这是故意设计，不是 bug。
-
GOROOT必须指向你解压后的根目录，例如/usr/local/go（Linux/macOS）或C:\Go（Windows），不能指向bin子目录 -
GOPATH可自定义（如$HOME/go），但不要和GOROOT重叠；Go 1.16+ 默认启用 module 模式，GOPATH主要影响go install生成的二进制存放位置 - 务必把
$GOROOT/bin和$GOPATH/bin都加入PATH，缺一不可；否则go命令可用，但gopls或dlv可能找不到
验证安装时别只跑 go version
go version 只说明命令存在，不代表模块构建、依赖下载、工具链都正常。
- 新建测试目录，执行
go mod init example.com/test，看是否生成go.mod - 运行
go get github.com/golang/example/hello@latest，再go run hello.go（若提示找不到文件，说明GOPATH下的src未被识别，大概率是PATH漏了$GOPATH/bin） - VS Code 用户还需检查
go.toolsGopath设置是否为空（新版推荐留空，由 Go 自动推导），否则会绕过你设的GOPATH
真正容易被忽略的是 shell 配置文件的加载时机：改完 ~/.zshrc 或 ~/.bash_profile 后，要么新开终端，要么手动 source，否则 go env 显示的仍是旧值。Windows 用户注意区分系统级和用户级环境变量——PowerShell 和 CMD 读取逻辑不同，优先用 PowerShell 测试。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
