Go环境配置失败主因是GOROOT、PATH、GO111MODULE和GOPROXY未正确设置：需确认GOROOT指向Go安装目录且PATH包含$GOROOT/bin；GO111MODULE必须显式设为on；国内用户还需配置GOPROXY为https://goproxy.cn等镜像；新项目须运行go mod init初始化模块，避免误入GOPATH模式。
Go 环境装不起来，八成卡在 go version 报错或 go run 找不到包——不是你手速慢，是几个关键配置没对齐。
go version 命令无效？先确认 PATH 和 GOROOT 是否真生效
Windows 用户双击 .msi 安装后，必须关掉所有 CMD/PowerShell 窗口再重开，否则系统 PATH 里的 C:\Program Files\Go\bin 不会加载。macOS/Linux 用户如果手动解压 tar.gz，GOROOT 必须显式设为解压路径（比如 /usr/local/go），且 PATH 要包含 $GOROOT/bin。
-
go env GOROOT输出为空或错误路径 → 说明GOROOT没设或设错 -
echo $PATH（macOS/Linux）或echo %PATH%（Windows）里没有go/bin路径 →go命令根本找不到 - 即使
go version成功，go env GOPATH仍可能为空 —— 现代 Go 模块模式下GOPATH不强制，但某些旧工具（如go get无模块时）会 fallback 到它
go run main.go 报 “package xxx is not in GOROOT”？大概率是模块未初始化或目录结构错
这个错误不是 Go 找不到标准库，而是它误把你的项目当成标准库的一部分去查了。根本原因是：当前目录没 go.mod，且项目不在 $GOPATH/src 下（旧式 GOPATH 模式），Go 就会退回到 GOROOT/src 里找包。
- 新建项目第一件事：在项目根目录运行
go mod init example.com/myapp（域名随意，只是模块标识） - 确保
main.go在当前目录，且文件开头是package main - 不要把项目放在
$GOROOT/src或$GOPATH/src下——模块模式下，放哪都行，只要顶层有go.mod - VS Code 的 Code Runner 插件默认执行
go run /full/path/to/main.go，会破坏相对路径上下文；应改配置为"go": "cd $dir && go run *.go"
依赖拉不下来、timeout？GOPROXY 和 GO111MODULE 必须同时开启
国内用户不配代理，go get 或 go build 遇到第三方包基本卡死。但只设 GOPROXY 不够，GO111MODULE 必须为 on，否则 Go 会忽略 GOPROXY 直接走 GOPATH 模式。
立即学习“go语言免费学习笔记（深入）”；
- 验证命令：
go env GO111MODULE应输出on；go env GOPROXY应含https://goproxy.cn或类似国内镜像 - Windows CMD 用
go env -w GO111MODULE=on；PowerShell 用[Environment]::SetEnvironmentVariable("GO111MODULE", "on", "Machine") - Linux/macOS 写入
~/.bashrc或~/.zshrc后，必须source ~/.zshrc生效，不能只改文件就完事 -
direct是回源开关：代理找不到包时自动连官方源，避免私有模块漏配
编译出来的二进制文件跑不了？注意 CGO_ENABLED 和目标平台
go build 默认启用 CGO，一旦调用 C 代码（比如某些数据库驱动、图形库），跨平台编译就会失败或生成带动态链接的文件。纯 Go 项目想一键打包部署，得关掉它。
- 交叉编译 Linux 二进制到 Windows：先设环境变量
CGO_ENABLED=0，再GOOS=windows GOARCH=amd64 go build -o app.exe - 本地构建默认用当前系统
GOOS/GOARCH，无需指定；但CGO_ENABLED=0可让结果更轻量、更可移植 - 若用到了
net/http、encoding/json这类纯 Go 标准库，CGO_ENABLED=0完全安全；但用了database/sql+mysql驱动，就得确认驱动是否支持纯 Go 模式（如github.com/go-sql-driver/mysql支持，github.com/ziutek/mymysql不支持）
最易被忽略的一点：Go 1.16+ 默认关闭 GO111MODULE 的 auto-detect 行为，哪怕目录里有 go.mod，如果 GO111MODULE=auto 或未设，它仍可能 fallback 到 GOPATH 模式——所以务必显式设为 on，别信“新版默认开启”的说法。
