Go环境搭建难点在于理清GOPATH、GOBIN、go mod与GOROOT关系；需先用go version确认已安装且版本≥1.18，避免因旧版（如1.16）或残留路径导致包找不到、命令不可调用等问题。
Go 开发环境搭建本身不难，真正卡住人的往往不是安装步骤，而是 GOPATH、GOBIN、模块模式（go mod）和 GOROOT 之间的关系没理清，导致 go run 找不到包、go install 安装的命令无法在终端直接调用，或者 IDE 显示“package not found”。
确认系统是否已装 Go 及版本是否合适
别急着重装，先查清楚现状。很多 macOS 用户通过 Homebrew 装过旧版（如 1.16），而新版项目依赖 go mod 的默认行为或泛型特性，必须 ≥ 1.18；Windows 用户可能残留了 MSI 安装器留下的注册表路径干扰。
- 运行
go version，输出应类似go version go1.22.3 darwin/arm64（macOS）或go version go1.22.3 windows/amd64 - 若提示
command not found或版本，才需要重装 - 检查
which go（macOS/Linux）或where go（Windows），确认二进制路径是否混杂（比如同时存在/usr/local/go/bin/go和~/sdk/go1.20.5/bin/go）
下载并配置官方二进制包（推荐，绕过包管理器陷阱）
Homebrew（macOS）、apt（Ubuntu）、choco（Windows）看似方便，但升级/降级时容易残留旧 GOROOT 或 PATH 冲突。直接下载官方压缩包最可控。
- 去 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载对应系统的
go（如. - .tar.gz go1.22.3.darwin-arm64.tar.gz） - 解压到固定位置：
sudo tar -C /usr/local -xzf go.tar.gz（macOS/Linux），或解压到C:\Go（Windows） - 把
/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows）加进PATH—— 注意：不是加/usr/local/go，是加它的bin子目录 - 重启终端或执行
source ~/.zshrc（macOS）/source ~/.bashrc（Linux）/refreshenv（PowerShell + scoop/choco）
初始化工作区：go mod 是默认，GOPATH 已退居二线
Go 1.16+ 默认启用模块模式，GO111MODULE=on 不再需要手动设置。此时 GOPATH 仅用于存放 go install 编译的可执行文件（即 $GOPATH/bin），不再是源码存放地。
立即学习“go语言免费学习笔记（深入）”；
- 新建项目目录，进入后运行
go mod init example.com/myapp—— 域名只是命名空间，无需真实存在 - 写个
main.go，运行go run main.go，不报错即通 - 想让
myapp命令全局可用？用go install .（注意末尾的点），它会把二进制放进$GOPATH/bin，前提是该目录已在PATH中 - 验证
$GOPATH当前值：运行go env GOPATH，默认是$HOME/go；如需改，设环境变量GOPATH=/your/custom/path并重载 shell
VS Code 配置要点：别只装 Go 插件
装完 golang.go 插件后，90% 的“无法跳转定义”“找不到包”问题，源于没正确指定 gopls（Go 语言服务器）的启动方式或工作区设置。
- 确保
gopls已安装：终端运行go install golang.org/x/tools/gopls@latest，完成后gopls -v version应有输出 - VS Code 设置中搜索
go.goplsArgs，清空它（留空）—— 新版gopls不需要手动传参，填了反而易错 - 打开的是模块根目录（含
go.mod文件的文件夹），不是父级文件夹；否则gopls启动失败，IDE 就变纯文本编辑器 - 如用 WSL，确认 VS Code 是通过
code .在 WSL 终端中打开的，而非 Windows 文件资源管理器直接双击
最常被忽略的一点：go install 生成的可执行文件，必须依赖 $GOPATH/bin 在 PATH 中才能直接敲命令运行。很多人配好了 Go，却忘了把这一行加进 shell 配置文件，或者加了但没重载，然后反复怀疑是不是 Go 没装对。
