go version失败主因是PATH未生效且终端未重启；MSI虽自动添加C:\Go\bin到PATH，但仅新终端可见，需关闭旧CMD/PowerShell并验证echo %PATH%含该路径。
go version 命令失败？先盯住 PATH 和终端重启
Windows 用户装完 MSI 包却执行 go version 报“不是内部或外部命令”，90% 是环境变量没生效。MSI 确实会自动加 C:\Go\bin 到系统 PATH，但只对新打开的终端生效。
- 已打开的 CMD/PowerShell 不会刷新 PATH，必须关掉重开
- 验证方法：在新终端里运行
echo %PATH%，看输出里有没有C:\Go\bin（注意别带引号、别加末尾反斜杠） - 如果没出现，手动进「系统属性 → 高级 → 环境变量」，在系统变量的
Path里新增一行：C:\Go\bin - 不要设
GOROOT手动环境变量——MSI 已内置处理，额外设置反而可能冲突
go run hello.go 报 cannot find module providing package fmt？缺 go.mod 是主因
Go 1.16+ 默认启用 GO111MODULE=on，意味着任何导入（包括标准库 fmt）都要求当前目录有 go.mod。没它，连 fmt 都找不到。
- 解决方法极简：在
hello.go所在目录下运行go mod init hello（模块名可任意，不需真实域名） - 确认文件名是
hello.go，不是hello.go.txt或隐藏扩展名；内容必须严格为package main+import "fmt"+func main() - 运行命令只能是
go run hello.go，不是go run .（后者要求当前是模块根目录） - 别手动改
GOPATH：默认C:\Users\用户名\go安全可用，改了反而容易和 VS Code 的 Go 扩展工具链打架
go get 或 go install 工具失败？检查模块上下文和代理
go get golang.org/x/tools/gopls@latest 报 failed to load mod file，通常不是网络问题，而是你在非模块目录下执行了命令。
- 临时装工具（如
gopls、air），加-d参数跳过构建：go get -d golang.org/x/tools/gopls@latest - 更推荐用
go install（Go 1.16+ 替代go get）：go install golang.org/x/tools/gopls@latest - 国内用户务必设代理，否则
golang.org/x/类包基本拉不下来：go env -w GOPROXY=https://goproxy.cn,direct - 别在
%GOPATH%\src下执行这些命令——Go 1.16+ 已弃用 GOPATH 模式，进去就容易触发兼容性错误
GOROOT 设错会导致构建彻底失效
go env GOROOT 输出路径不对（比如显示 C:\Users\xxx\go），说明你或某个配置文件错误覆盖了它。GOROOT 必须指向 Go 安装根目录（如 C:\Go），不是项目目录，也不是 GOPATH。
立即学习“go语言免费学习笔记（深入）”；
- 查所有 shell 配置文件（
%USERPROFILE%\Documents\PowerShell\Microsoft.PowerShell_profile.ps1、%USERPROFILE%\AppData\Roaming\Code\User\settings.json等），删掉export GOROOT=...或set GOROOT=...这类行 - VS Code 的 Go 扩展有时会偷偷写入 workspace 设置，检查项目根目录下的
.vscode/settings.json是否含"go.goroot"字段 - 改完后重启终端和 VS Code，再跑
go env GOROOT确认输出是C:\Go（或你实际安装路径）
go get 或 go install。 
