goroot和gopath路径必须为纯英文、无空格、无特殊符号，goroot须指向go安装根目录（含src/pkg/bin），gopath若设置需符合传统结构，且path必须包含%goroot%\bin。
GOROOT 和 GOPATH 路径不能含中文、空格或特殊符号
Windows 下常见错误是把 Go 安装到 C:\Program Files\Go 或 D:\Go 语言，这会导致 go build、go mod download 等命令静默失败，甚至报错 exec: "gcc": executable file not found in %PATH%（实际是路径解析中断引发的连锁问题）。
根本原因在于 Go 工具链底层调用大量 C 工具链和 shell 脚本，路径中空格或中文会破坏参数传递。哪怕你手动加引号，Go 自身的 filepath 处理逻辑也不保证兼容。
- 推荐安装路径：如
D:\go或D:\soft\go（纯英文、无空格、无括号） - GOPATH 同理：避免
D:\my go projects，改用D:\gopath或%USERPROFILE%\go - 验证方式：在 cmd 中运行
echo %GOROOT%和echo %GOPATH%，确认输出不含空格或乱码
GOROOT 必须指向 Go 安装根目录，不是 bin 子目录
新手常把 GOROOT 设成 D:\go\bin，结果 go version 能运行，但 go run 报 cannot find package "fmt" —— 因为 Go 运行时需要从 GOROOT/src 和 GOROOT/pkg 加载标准库。
GOROOT 的唯一作用是定位 Go 自带的编译器、标准库和工具二进制文件。它和项目代码完全无关。
- 正确值示例：
D:\go（对应目录下应有src、pkg、bin三个子目录） - 错误值示例：
D:\go\bin、D:\go\src、C:\Users\Name\go（除非你真把整个 Go 安装包解压到了那里） - 检查方法：运行
go env GOROOT，再手动进入该路径确认是否存在src/fmt目录
GOPATH 在 Go 1.16+ 已非必需，但设了就得合规
启用 Go Modules 后，GOPATH 不再参与依赖解析，但它仍影响 go install 输出位置、go get（不带 @version 时）行为，以及部分老工具（如 gopls 的缓存路径）。
如果你设了 GOPATH，就必须满足传统结构：GOPATH/src 存源码、GOPATH/bin 存可执行文件、GOPATH/pkg 存编译缓存。否则 go install 可能写入错误位置，或 go list -m all 显示异常模块路径。
- 现代推荐：干脆不设
GOPATH，让 Go 使用默认值（%USERPROFILE%\goon Windows），或设一个干净路径如D:\gopath并确保其下有src、bin、pkg - 危险操作：把
GOPATH指向项目根目录（如D:\myproject），会导致go mod init创建的go.mod被误认为在src/下，引发 import 路径混乱 - 注意：
go env -w GOPATH=...会写入用户级配置，比系统环境变量优先级高，调试时容易忽略
PATH 中必须包含 %GOROOT%\bin，且顺序无关紧要
PATH 里漏掉 %GOROOT%\bin 是最隐蔽的失败点：你可能看到 go version 正常输出，但 go fmt 或 go test 找不到命令 —— 实际是调用了旧版本或别处的二进制文件。
只要 %GOROOT%\bin 在 PATH 中，顺序不影响功能（Go 工具链不依赖其他同名命令）。但若同时装了多个 Go 版本，顺序会影响 go 命令默认调用哪个。
- 务必验证：
where go（Windows）或which go（macOS/Linux），输出应为%GOROOT%\bin\go.exe - 不要只加
%GOPATH%\bin就以为够了——那是放go install结果的，不是放 Go 本身 - PowerShell 用户注意：
$env:PATH修改后需重启终端，go env显示的GOPATH和GOROOT是最终生效值，不是环境变量原始值
go mod tidy 失败，背后可能是 GOROOT 指向了空目录；go run main.go 报找不到包，实际是 GOPATH 路径含空格导致 go list 解析中断。这些都得靠 go env 和手动 dir 验证，而不是只看错误提示。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
