先查PATH是否包含go二进制路径；GOPATH现代项目虽非必需，但go install依赖它；gopls需手动安装并设GOPROXY；go build要求当前目录有go.mod。
go version 命令不识别？先查 PATH 是否包含 go 二进制路径
这不是 Go 没装好，而是 shell 找不到 go 可执行文件。Windows 安装 .msi 后通常自动加了 %GOROOT%\bin 到系统 PATH；macOS/Linux 却常漏掉这步。
- 运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里含/usr/local/go/bin（macOS）、C:\Go\bin或你自定义的安装路径下的\bin - 若缺失，手动追加：macOS/Linux 编辑
~/.zshrc或~/.bashrc，加入export PATH=$PATH:/usr/local/go/bin；Windows 在“环境变量”里编辑 PATH，新增一行 - 改完别忘了重载配置：
source ~/.zshrc或重启终端；Windows 需新开 CMD/PowerShell
GOPATH 还需要手动设吗？现代项目基本不用，但 go install 依赖它
Go 1.16+ 默认启用模块模式（go mod），GOPATH 对项目构建已无强制要求。但它仍控制 go install 安装的可执行文件存放位置 —— 即 $GOPATH/bin。
- 不设
GOPATH时，go install会报错或静默失败（尤其在 macOS/Linux 上） - 推荐显式设置：Linux/macOS 加入
export GOPATH=$HOME/go到 shell 配置；Windows 用setx GOPATH "%USERPROFILE%\go" - 确保
$GOPATH/bin也在 PATH 中，否则安装的工具（如dlv、gopls）命令不可用
VSCode 提示 “gopls not found”？不是插件问题，是工具没装全
VSCode 的 Go 插件默认调用 gopls（Go Language Server）提供智能提示、跳转等功能。它不随插件一起安装，需单独获取。
- 首次打开 .go 文件时，底部状态栏出现 “Installing tools” 提示，点击后选
Install All是最稳妥方式 - 若卡住或失败，手动运行：
go install golang.org/x/tools/gopls@latest；注意 Go 版本需 ≥ 1.18，否则可能因代理或模块解析失败 - 国内用户务必提前设好代理：
go env -w GOPROXY=https://proxy.golang.org,direct或换为https://goproxy.cn - 装完验证：
gopls version应输出版本号；VSCode 里按 Ctrl/Cmd + Shift + P → 输入 “Go: Restart Language Server” 强制重载
go run 成功但 go build 报错？检查当前目录是否在模块内
go build 和 go run 行为差异常源于模块上下文。go run main.go 可绕过模块检查直接编译单文件；go build 默认要求当前目录存在 go.mod，否则报 no modules found。
立即学习“go语言免费学习笔记（深入）”；
- 新建项目务必先初始化模块：
go mod init example.com/myapp，生成go.mod文件 - 若已有
go.mod但go build仍失败，运行go mod tidy补全依赖并校验路径 - 避免在
$GOPATH/src下直接建项目 —— 这是旧式 GOPATH 模式，与模块模式冲突，容易引发导入路径解析错误
GOPROXY 不设，go get 和 go install 就可能超时或 403；gopls 不装，VSCode 的跳转和补全就只剩基础语法高亮；而 go.mod 不在根目录，go build 就永远找不到包。这些不是“高级配置”，是每天敲命令前必须存在的前提。 
