Go环境配置规范需确保GOROOT正确、GO111MODULE=on启用模块、GOPROXY设为带direct的国内镜像（如https://goproxy.cn,direct），且go mod init后立即执行go mod tidy，三者缺一不可。
Go 环境能跑 go run 不等于配置规范 —— 多数人卡在 GOPATH、代理、模块初始化这三处，后续依赖拉不下来、go mod tidy 报错、IDE 识别不了包，根源都在初始配置没对齐现代 Go（1.16+）默认行为。
GOROOT 和 GOPATH 还需要手动设吗？
Go 1.16 起默认启用 Go Modules，GOPATH 不再是必须项，但 GOROOT 必须正确指向安装目录（比如 C:\Go 或 /usr/local/go），否则 go 命令根本找不到编译器。
- Windows 安装 .msi 包通常自动设好
GOROOT，但若手动解压 zip，必须自己加GOROOT到系统环境变量，并把%GOROOT%\bin加入PATH -
GOPATH可以不设 —— 新项目用go mod init后，依赖会下载到$GOPATH/pkg/mod（即使没显式设GOPATH，Go 也会 fallback 到默认路径，如$HOME/go） - 如果非要自定义
GOPATH（例如统一管理多个旧项目），路径里不能含空格或中文，且需确保$GOPATH/bin在PATH中，否则go install的二进制找不到
go env -w 设置的代理为什么不起作用？
常见现象：go env -w GOPROXY=https://goproxy.io 执行后，go mod download 仍超时或报 proxy.golang.org:443: no such host —— 本质是 Go 默认代理链未生效，或被 IDE 缓存覆盖。
- 必须同时开启模块模式：
go env -w GO111MODULE=on，否则 Go 无视GOPROXY - 推荐值不是单个地址，而是带 fallback 的逗号分隔串：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,https://goproxy.io,direct，最后的direct是兜底，避免镜像临时不可用时整个流程卡死 - VS Code 或 GoLand 会读取自己的设置（如 Go 插件里的 “GOPROXY” 字段），优先级可能高于
go env，需检查 IDE 设置里是否填了空值或错误地址 - 执行
go env GOPROXY确认输出是你刚设的值，而不是空或https://proxy.golang.org
go mod init 初始化失败的三个典型原因
go mod init myproject 报错 “cannot determine module path” 或直接退出无声，基本就这三类问题。
立即学习“go语言免费学习笔记（深入）”；
- 当前目录路径含中文、空格或特殊符号（如
D:\我的项目\api）—— Go 模块路径必须是合法域名格式，建议全英文路径，如D:\projects\myapi - 父目录已存在
go.mod（比如你在~/go/src/github.com/user/repo下执行，而~/go是旧 GOPATH，顶层已有go.mod）—— Go 会沿目录树向上找，找到就用那个，导致当前目录无法独立初始化 - 没关掉 Windows Defender 实时防护或某些国产杀软 —— 它们会拦截
go进程写临时文件，表现为命令卡住几秒后失败，关闭防护后重试即可
验证环境是否真正可用的最小闭环
别只测 go version，那只能说明二进制存在。真正要跑通的是模块依赖 + 编译 + 运行三连。
- 新建空目录，进入后执行：
go mod init example.com/hello - 写一个
main.go，内容仅一行：package main; import "rsc.io/quote"; func main() { println(quote.Hello()) } - 运行：
go mod tidy（应自动下载rsc.io/quote）→go build（生成可执行文件）→./hello（或hello.exe）输出Hello, Gopher! - 任一环节失败，就不是环境问题，而是配置细节没对上：比如代理没生效、
GO111MODULE关闭、或网络策略拦截了https://请求
实际项目里，go mod 的行为受 GOPROXY、GOINSECURE、GO111MODULE 三者共同影响，任何一个配错都会让依赖变成“薛定谔的下载”。调试时不要猜，先 go env 看真实值，再结合 go mod download -x 看详细日志。
