Go环境配置错误常导致command not found等报错，核心在于GOROOT、GOPATH、go mod与PATH混淆；需确保GOROOT与which go一致，GOPATH/bin加入PATH，正确设置GOPROXY和GO111MODULE，并避免手动干预GOPATH/src。
Go 环境能跑起来，不等于环境搭对了；很多报错（比如 command not found、package not found、go install 生成的命令用不了）根本不是没装 Go，而是 GOROOT、GOPATH、go mod 和 PATH 混在一起没理清。
go version 显示版本但 go run 报错找不到包
这是最典型的“看似装好了，实则路径错乱”现象。常见于 macOS/Linux 用户用 Homebrew 装过旧版 Go（如 1.16），又手动解压新版覆盖，导致 GOROOT 指向旧目录，而 go 二进制却来自新路径。
- 运行
which go和go env GOROOT，两者输出必须一致；如果不一致，说明GOROOT被残留配置污染 - 删掉所有 shell 配置文件（
~/.zshrc、~/.bash_profile等）里手动写的export GOROOT=...，让 Go 自动推导 - 确认
PATH中只有一处/usr/local/go/bin（macOS 官方 pkg）或C:\Go\bin（Windows MSI），不要同时存在多个go二进制路径 - 执行
go env -w GOROOT=""清空手动设置，重启终端再试
go mod init 后 go run 正常，但 go install . 不生效
go install 生成的可执行文件默认放进 $GOPATH/bin，而不是当前目录或系统 /usr/local/bin。如果 $GOPATH/bin 不在 PATH 里，就找不到命令。
- 运行
go env GOPATH查当前值（默认是$HOME/go），然后确认$GOPATH/bin是否已加入PATH - Windows 用户注意：PowerShell 中要用
$env:PATH += ";$env:GOPATH\bin"，CMD 用set PATH=%PATH%;%GOPATH%\bin - 别把
go install和go build混用：go build生成本地二进制，go install才放$GOPATH/bin - 如果想跳过
GOPATH直接安装到自定义位置，可用GOBIN=/your/path go install .
国内用户 go get 或 go mod tidy 卡住或超时
这不是网络问题，而是模块代理没设对。Go 默认走 proxy.golang.org，国内直连基本不可用，但只设 GOPROXY 还不够。
立即学习“go语言免费学习笔记（深入）”；
- 必须同时启用模块模式：
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但旧 shell 配置可能关掉它） - 推荐代理配置：
go env -w GOPROXY=https://goproxy.cn,direct—— 注意,direct不能漏，否则私有模块无法拉取 - 若公司有私有仓库，加
go env -w GOPRIVATE=git.example.com/internal，避免被代理劫持 - 验证是否生效：
go env GOPROXY输出应含goproxy.cn，且go mod download -x能看到请求发往该域名
VS Code 中调试失败或提示 “No Go files in workspace”
VS Code 的 Go 扩展（golang.go）依赖 gopls，而 gopls 启动失败多数是因为工作区没识别为 Go 模块。
- 确保项目根目录下有
go.mod文件；没有就先go mod init example.com/myapp - 关闭 VS Code，删掉项目下的
.vscode/和go.work（如有），重开后让扩展重新初始化 - 检查状态栏右下角是否显示 Go 版本和
gopls状态；若显示 “Loading…” 卡住，终端执行go install golang.org/x/tools/gopls@latest - Windows 用户注意：PowerShell 默认执行策略可能阻止
gopls启动，临时用Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
真正容易被忽略的，是 GOROOT 和 GOPATH 的职责边界：前者只管 Go 自身安装路径，后者只管 go install 输出位置，源码放哪、模块在哪，全由 go mod 决定——别再往 $GOPATH/src 里扔代码了。
