绝大多数情况下无需手动配置GOROOT，Go安装包会自动设置；仅多版本管理或Docker构建时需显式导出，误设会导致标准库失联和命令报错。
GOROOT 用不用手动配？
绝大多数情况下，GOROOT 不用手动配置——Go 安装包（如官方二进制、Homebrew、apt）会自动写入正确路径。你只需运行 go env GOROOT 确认它指向了真实安装目录（例如 /usr/local/go 或 C:\Go）即可。只有当你同时装了多个 Go 版本、用 g 或 gvm 切换，或在 Docker 构建中指定多版本时，才需要显式导出 GOROOT。
误设 GOROOT 的后果很直接：所有 go 命令会报错，比如 go: cannot find main module 或找不到 fmt 包——因为工具链和标准库源码（$GOROOT/src/fmt）彻底失联。
- ✅ 正确做法：不碰它，除非你明确知道为什么改
- ❌ 常见错误：复制网上旧教程，盲目加
export GOROOT=/usr/local/go到 shell 配置里，结果和自动识别值冲突，导致go build失败 - ⚠️ 验证命令：
go env GOROOT输出应为有效路径，且该路径下必须存在src/、bin/、pkg/三个子目录
GOPATH 还要不要设？设在哪？
GO111MODULE=on（Go 1.16+ 默认开启）后，GOPATH 已不是项目构建必需项，但它仍承担三项不可替代的职责：存放 go install 安装的工具（如 gopls、stringer）、缓存模块（$GOPATH/pkg/mod）、兼容部分 IDE 和旧脚本。所以建议保留默认值，不要删掉。
- ✅ 推荐做法：不手动设置
GOPATH，让它保持系统默认（Linux/macOS 是$HOME/go，Windows 是%USERPROFILE%\go） - ✅ 必须做的一件事：确保
$GOPATH/bin在PATH中，否则go install github.com/golang/mock/mockgen@latest装完也运行不了 - ❌ 绝对禁止：把
GOPATH设成和GOROOT相同（比如都设为/usr/local/go），Go 会立刻报错error: $GOPATH must not be set to $GOROOT - ⚠️ 路径要求：选无空格、无中文、权限干净的路径；若自定义（如
$HOME/mygo），需同步更新PATH并重启终端
为什么 GOPATH 和 GOROOT 必须分开？
这不是“建议”，而是 Go 工具链的硬性校验。根本原因在于职责隔离：GOROOT/src 是 Go 标准库的只读“圣域”，而 GOPATH/src 是用户代码的可写“沙盒”。混在一起会直接破坏环境稳定性。
- ? 实际风险：你在
$GOROOT/src/net/http下新建个myserver.go，下次升级 Go 就可能被覆盖；或者go get把第三方包下到$GOROOT/src/github.com/...，导致go build找到的是你本地乱改过的“伪标准库” - ? 查找逻辑：当 import
"github.com/gin-gonic/gin"时，Go 先查$GOROOT/src（没得），再查$GOPATH/src（旧模式）或$GOPATH/pkg/mod（Modules 模式）。路径重叠会让这个查找链条失效 - ? 强制机制：从 Go 1.0 开始就内置校验，哪怕你绕过 shell 变量用
env GOPATH=$GOROOT go run main.go，也会被立即拦截
模块时代下，项目还用放 GOPATH/src 里吗？
完全不用。这是最容易被旧资料误导的点。Go Modules 启用后（go mod init 生成 go.mod），你的项目可以放在磁盘任意位置，go 命令只认当前目录是否有 go.mod，不再看它是不是在 $GOPATH/src/github.com/xxx/yyy 下。
- ✅ 正确姿势：在
~/projects/myapp直接go mod init myapp，然后go run .—— 完全绕过GOPATH/src - ❌ 错误习惯：仍把项目 clone 到
$GOPATH/src/下却不加go.mod，结果 Go 自动降级为 GOPATH 模式，replace和require全部失效 - ? 缓存仍在 GOPATH：虽然项目不放 src 里了，但下载的依赖依然缓存在
$GOPATH/pkg/mod，所以GOPATH的磁盘空间和路径合法性依然重要
真正容易被忽略的，是 $GOPATH/bin 是否真的在 PATH 里生效——很多人改完 ~/.zshrc 就以为成了，其实没 source 或没重启终端，导致 gopls 找不到，IDE 报一堆红波浪线。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
