必须运行go version和go env验证：go version报错说明PATH未含GOROOT/bin；go env确认GOROOT、GOPATH、GOBIN值是否正确；再用go run hello.go验证编译链，gopls version检查语言服务器。
Go 环境装完不验证，等于没装——go version 和 go env 是唯二必须跑通的命令，其他都可能被缓存、代理或编辑器误导。
运行 go version 看是否识别命令
这是最基础的“命令是否存在”检查。如果报错 'go' is not recognized as an internal or external command（Windows）或 command not found: go（macOS/Linux），说明 %GOROOT%\bin 或 /usr/local/go/bin 没进 PATH，或者安装根本没完成。
- Windows 用户：确认你添加的是
%GOROOT%\bin，不是%GOROOT%\；且变量名GOROOT必须存在，否则%GOROOT%\bin展开失败 - macOS/Linux 用户：检查
~/.zshrc或~/.bash_profile是否执行了source，终端新开一个再试，别只在当前 tab 里改完就跑 - WSL2 用户：注意 Windows 的 PATH 不会自动继承到 WSL，必须在 Linux shell 里单独配
执行 go env 确认关键变量值
go env 输出的是 Go 运行时实际读取的环境快照，比手动查系统变量更可信。重点关注三处：
-
GOROOT：应指向你解压/安装 Go 的根目录（如D:\Go或/usr/local/go），不能是空、auto或路径错误 -
GOPATH：现代 Go 模块模式下它不影响编译，但go install和部分工具（如gopls）仍依赖它；若为空，go env -w GOPATH=xxx可临时写入 -
GOBIN：默认是$GOPATH/bin，所有go install的二进制都会放这儿；确保该目录在PATH中，否则装了dlv也调用不了
用 go run 写个最小 hello world
光有命令和变量还不够，得验证编译链完整。别跳过这步——有些 MSI 安装包在杀毒软件拦截下会静默失败，go version 能过但 go run 报 exec: "gcc": executable file not found。
- 新建文件
hello.go，内容仅一行：package main; import "fmt"; func main() { fmt.Println("ok") } - 终端进入该目录，运行
go run hello.go - 预期输出
ok；若卡住、报错或提示build failed，大概率是GCC缺失（Windows 上需安装 TDM-GCC 或 MinGW-w64）、或CGO_ENABLED=0被误设
检查 gopls 是否就绪（VSCode 用户必做）
VSCode 的 Go 扩展靠 gopls 提供补全、跳转、诊断等功能。它不随 Go 本体安装，也不在 go env 里体现，容易漏验。
- 终端执行
gopls version，应输出类似gopls version v0.15.2；若报错，说明 VSCode 提示的 “install tools” 没点确认，或网络被墙导致下载失败 - 在 VSCode 中打开一个
.go文件，看右下角状态栏是否显示gopls (running)；若一直显示Starting...，大概率是gopls启动卡在模块加载，可尝试删掉项目根目录下的go.mod和go.sum重试 - 别信 VSCode 弹窗说“已安装全部工具”——它有时把失败当成功，务必手动敲命令验证
真正容易被忽略的，是 GOBIN 目录权限和 gopls 的静默失败。前者导致 go install 看似成功实则没生成可执行文件，后者让编辑器看起来正常，但 Ctrl+Click 跳转永远转不到定义里。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
