GOROOT必须设置（指向Go安装根目录），GOPATH在Go 1.16+模块模式下非必需；关键要确保GO111MODULE=on、GOROOT正确、GOBIN或GOPATH/bin加入PATH，且IDE指向含go.exe的GOROOT根目录。
Go 环境能跑 go version 就算搭好了，但真正写代码时卡在 import 找不到包、go run 报错、IDE 识别不了 SDK，八成是环境变量或模块配置没对齐——不是版本问题，而是路径和作用域混乱。
GOROOT 和 GOPATH 到底要不要设？
Go 1.16+ 默认启用 Go Modules，GOROOT 必须设（指向 Go 安装目录，如 C:\Go 或 /usr/local/go），但 GOPATH 已非必需：
- 不设
GOPATH时，go mod init初始化的项目可直接在任意路径开发，依赖缓存在$HOME/go/pkg/mod（Linux/macOS）或%USERPROFILE%\go\pkg\mod（Windows） - 设了
GOPATH却没启用 Modules，go get会强行把包下到$GOPATH/src，而go run又可能因未在src下找不到入口文件失败 - 常见错误：
cannot find package "xxx"往往不是包不存在，而是当前目录没go.mod，或GO111MODULE=off强制退回到 GOPATH 模式
Windows 下 PATH 配置最容易漏掉的两个位置
只加 %GOROOT%\bin 不够，go 命令能用，但 go install 生成的二进制文件可能找不到：
- 必须把
%GOBIN%（如C:\GoProject\bin）也加进系统PATH，否则执行go install后，命令行里直接敲生成的可执行名会提示“不是内部或外部命令” - 如果用了自定义
GOPATH，还要确保%GOPATH%\bin在PATH中——但注意：Go Modules 启用后，go install默认不再写入GOPATH\bin，而是写入GOBIN - 验证方式：运行
go env GOPATH和go env GOBIN，再检查echo %PATH%（Windows）是否包含这两个路径的bin目录
IDE 识别不了 Go SDK 的真实原因
IntelliJ/GoLand 或 VS Code 提示 “invalid Go SDK” 或 “The selected directory is not a valid home for Go SDK”，通常不是路径错，而是：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 选的是
C:\Go的父目录（比如C:\）或子目录（比如C:\Go\src），正确路径必须是包含bin\go.exe的那一层（即C:\Go） - Go 安装后被杀毒软件拦截，
go.exe被静默删改，表现为go version正常但 IDE 校验失败——重装前先关杀软 - VS Code 的 Go 插件要求
go在 PATH 中可用，且版本 ≥ 1.16；若插件报错 “Failed to find the ‘go’ binary”，先在终端运行where go（Windows）或which go（macOS/Linux）确认路径，再在插件设置里手动指定
代理和模块初始化绕不开的坑
国内拉 golang.org/x/... 包失败，不是单纯配代理就能解决：
- 先运行
go env -w GOPROXY=https://proxy.golang.com.cn,direct（官方推荐国内镜像），别用过期的https://goproxy.io - 如果已有
go.mod但go mod download卡住，试试go clean -modcache清掉坏缓存再重试 - 新建项目务必在项目根目录执行
go mod init myproject，不能跳过——否则import语句会被当成旧式 GOPATH 导入，导致找不到本地模块 - 临时关闭模块：设
GO111MODULE=off只适用于迁移老项目，新项目强推GO111MODULE=on（默认值）
最麻烦的从来不是装不上 Go，而是多个环境变量、多种模块模式、不同 IDE 的缓存机制混在一起——改完一个地方，记得全量验证：go version、go env GOPROXY、go list -m all、IDE 重启、新建项目跑通 go run main.go。少一个环节，就可能埋个三天都看不出来源的隐性故障。
