Go环境配置成功需满足：go version能运行仅是基础，必须验证go env GOPATH、设置GO111MODULE=on、GOPROXY=https://goproxy.cn,direct、GOSUMDB=sum.golang.org，并安装gopls及dlv，VSCode中启用go.useLanguageServer且工作区含go.mod。
go version 能跑出来，不代表环境真配好了——很多新手卡在依赖拉不下来、go run 报错、VSCode 里没代码提示，根源都在安装后那几步没做对。
Windows 安装完 .msi 后必须关掉所有 CMD/PowerShell 窗口
.msi 安装包确实会自动写入 PATH，但 Windows 不会热更新已打开的终端进程。
你看到 go version 成功，只是因为某个旧窗口恰好继承了安装前就存在的缓存路径（比如之前装过旧版 Go），或者你用的是 Git Bash 这类独立 shell，它不读系统 PATH 更新。
验证方式：新开一个 PowerShell，直接输 go env GOPATH，如果报“找不到命令”，说明环境变量根本没生效。
正确做法：安装完立刻关闭所有终端窗口，再重新打开——别信“重启电脑”这种过度操作，关终端就行。
国内拉包失败？GOPROXY 必须设，且顺序不能错
go get 卡住、超时、报 module github.com/xxx: reading https://proxy.golang.org/xxx: 403 Forbidden，基本都是代理没配或配错了。
执行这三条命令（顺序不能颠倒）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org
注意：https://goproxy.cn 是七牛云维护的国内镜像，比 https://proxy.golang.org 稳定；direct 写在后面，表示当镜像里没有包时才回源，不是“备选”，是兜底逻辑。
立即学习“go语言免费学习笔记（深入）”；
验证是否生效：go env GOPROXY 输出应为 https://goproxy.cn,direct，而不是空或 https://proxy.golang.org。
go run 和 go build 的行为差异容易踩坑
新手常以为 go run main.go 成功 = 编译没问题，其实它只检查语法+依赖解析，不生成可执行文件；而 go build 才真正走完整编译链。
常见现象：
-
go run成功，但go build报cannot find module providing package xxx→ 没初始化模块，缺go mod init -
go run报no required module provides package→ 当前目录不在模块根目录，或没go.mod - 运行后控制台一闪而退 →
main()执行完程序立即退出，没加fmt.Scanln()或time.Sleep()阻塞
建议起步流程固定为三步：go mod init myapp → go run main.go → go build -o app.exe，每步都确认输出。
VSCode 插件装了但没提示？关键在 go.toolsGopath 和 go.useLanguageServer
Go 官方插件默认启用语言服务器（gopls），但它依赖本地工具链完整。
如果代码里 fmt. 没自动补全、跳转失效，先检查：
-
gopls是否已下载：在 VSCode 终端里执行go install golang.org/x/tools/gopls@latest -
go.toolsGopath设置是否为空（新版推荐留空，让插件自动管理工具路径） -
go.useLanguageServer是否为true（设置里搜这个选项，必须开）
不要手动改 GOROOT 或 GOPATH —— Go 1.16+ 默认用模块模式，这些变量仅用于兼容旧项目，强行设置反而干扰 gopls 解析。
go env -w 那几条命令，很多人复制粘贴时多了一个空格，或者用 PowerShell 执行却忘了加 -ExecutionPolicy RemoteSigned 权限，结果命令看似执行了，实际没写进环境变量。 
