GOROOT必须正确设置且PATH包含$GOROOT/bin，否则go version等命令失效；GOPATH在Go 1.11+模块模式下非必需，但影响go install工具安装路径和VSCode插件行为。
Go 环境现在不需要手动配 GOPATH 也能跑起来，但不设 GOROOT 或乱改 PATH 很容易 go version 找不到命令，或 go run 报错找不到工具链。
go version 命令无效？先确认 PATH 和 GOROOT 是否被正确识别
这是 Windows/macOS/Linux 新手最常卡住的第一步。安装完 .msi/.pkg/.tar.gz 后，go version 报“不是内部或外部命令”或“command not found”，基本就是 PATH 没生效。
- Windows：安装程序默认会加
%GOROOT%\bin到系统 PATH，但如果自定义了安装路径（比如装到D:\Go），就得手动把D:\Go\bin加进“系统变量 → Path” - macOS/Linux：解压后必须显式导出
PATH，例如在~/.zshrc中写export PATH=$PATH:/usr/local/go/bin；只写GOROOT不加PATH是没用的 - 别信“安装完就自动好”——打开新终端再试
go version，旧终端不会自动加载新 PATH - 验证是否识别 GOROOT：
go env GOROOT应该输出实际路径；如果为空，说明 Go 没法定位自身安装位置，go build可能静默失败
GOPATH 还需要手动设置吗？看你是用 modules 还是老式 src/pkg/bin 结构
Go 1.11+ 默认启用 modules，go mod init 后所有依赖都存到 GOMODCACHE（默认在 $HOME/go/pkg/mod），和 GOPATH 无关。但某些场景仍需明确 GOPATH：
- 你用
go get github.com/xxx/yyy安装命令行工具（如golangci-lint），它会被装到$GOPATH/bin，若 GOPATH 未设，golangci-lint就执行不了 - 你沿用旧项目结构（
$GOPATH/src/xxx），或公司内部 CI 脚本硬编码了 GOPATH 路径，那必须设，比如go env -w GOPATH=$HOME/go - VSCode 的 Go 插件默认读
go env GOPATH来找工具，不设可能导致 “dlv not found” 或格式化失效 - 现代推荐做法：保持默认
$HOME/go，不改；用go install xxx@latest替代老式go get，它会自动装进$GOPATH/bin
go mod init 报错“go: go.mod file already exists”或“unknown revision”？代理和缓存是关键
国内直接 go get 或 go mod tidy 经常卡住、超时、404，本质是模块索引和包下载走的是 proxy.golang.org，而它在国内不稳定。
立即学习“go语言免费学习笔记（深入）”；
- 必须设代理：
go env -w GOPROXY=https://proxy.golang.org,direct改成https://goproxy.cn,direct或https://mirrors.aliyun.com/goproxy/,direct - 如果之前失败过，本地缓存可能损坏，删掉
$GOMODCACHE下对应模块目录（或整个pkg/mod）再试 -
go mod init myproject必须在空目录下运行；若已有go.mod，就别重复 init，直接go mod tidy - 模块名不用非得是 URL，但建议用有意义的标识符（如
example.com/myapp），避免纯英文名导致后续go get解析歧义
VSCode 装了 Go 插件却没代码提示？检查 go.toolsGopath 和 Go 工具链路径
VSCode 的 Go 扩展（vscode-go）不是装上就自动工作，它依赖本地 Go 工具链的完整性和可访问性。
- 插件默认调用
gopls（Go language server），而gopls需要从$GOPATH/bin或$GOROOT/bin找到它；如果gopls没装，插件会提示下载，但有时权限或网络问题导致静默失败 - 手动装一次：
go install golang.org/x/tools/gopls@latest，确保它出现在$GOPATH/bin里 - VSCode 设置里搜
go.gopath，值应和go env GOPATH一致；再搜go.toolsGopath，也填同一路径（新版插件其实更倾向读go env，但显式指定更稳） - 打开一个
.go文件后，看右下角状态栏有没有 “Go” 图标和版本号；没有的话，按Cmd+Shift+P（macOS）或Ctrl+Shift+P（Win/Linux），输入 “Go: Install/Update Tools”，全选安装
真正容易被忽略的点是：GOROOT 和 GOPATH 的路径中不能含中文、空格或特殊符号，哪怕只是用户名带中文，都可能让 go test 或 dlv 调试器启动失败——这不是报错，而是进程直接退出，连日志都不打。
