go命令找不到的最常见原因是path未正确配置，需将go安装目录的bin路径（如/usr/local/go/bin或c:\go\bin）加入系统path，并确保shell配置文件（如~/.zshrc）已source生效，且ide继承该环境。
go 命令找不到？PATH 没加对是最常见原因
安装完 Go 后执行 go version 提示 command not found: go，基本就是 PATH 没生效。Windows 上 MSI 安装器勾选了 “Add Go to PATH” 也不一定真成功——它只改当前用户的环境变量，且可能被系统级 PATH 覆盖。
实操建议：
- Windows：打开「系统属性 → 高级 → 环境变量」，检查
Path中是否含C:\Go\bin（默认路径），**不是 C:\Go**；若手动添加，务必重启终端或新建 CMD/PowerShell 窗口 - macOS/Linux：确认
/usr/local/go/bin（Homebrew）或你解压的~/go/bin已写入~/.zshrc或~/.bash_profile，且执行过source ~/.zshrc - 验证方式：在新终端里运行
echo $PATH，搜索go/bin；再单独运行which go，输出路径必须和GOROOT一致
GOROOT 和 GOPATH 到底要不要手动设？
Go 1.16+ 默认启用模块（GO111MODULE=on），GOPATH 不再强制用于项目存放，但 GOROOT 必须正确 —— 它是 go 工具链自身的根目录，错了会导致 go build 找不到标准库。
实操建议：
-
GOROOT：Windows MSI 安装通常自动设好；Linux/macOS 手动解压时，必须显式设置，例如export GOROOT=$HOME/go；**不要把它和你的项目目录混为一谈** -
GOPATH：现代项目可不设，但如果你用go get（非模块方式）或跑老项目（如 Battery Historian 2.0），就得设，且需确保$GOPATH/src目录存在；推荐值：$HOME/go（macOS/Linux）或%USERPROFILE%\go（Windows） - 检查命令：
go env GOROOT和go env GOPATH，输出应是你预期的路径，而非空或默认值
go mod tidy 失败？大概率是 GOPROXY 或网络问题
执行 go mod tidy 卡住、报错 failed to download 或 missing go.sum entry，90% 和代理或模块开关有关。国内直连 golang.org 域名基本不可行。
实操建议：
- 先确认模块已开启：
go env GO111MODULE应输出on；若为auto，进项目外目录再进项目内可能触发不同行为，直接设为on更稳 - 设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct（direct表示私有模块走直连） - 若公司有内部 Nexus 或 Artifactory，替换为对应 URL；设完后删掉
go.sum和vendor/（如有），再跑go mod tidy - 注意：
go get拉特定版本时，别漏掉@vX.Y.Z，例如go get github.com/quic-go/quic-go@v0.46.0，否则可能拉到不稳定 commit
多个 Go 版本共存时，怎么确保用的是你想要的那个？
Homebrew、MSI、手动解压三种方式并存，which go 和 go version 可能指向不同位置，尤其 macOS 上 /usr/local/bin/go（Homebrew）和 /usr/local/go/bin/go（官网包）容易打架。
实操建议：
- 查真实路径：
which go+ls -l $(which go)，看软链接最终指向哪 - 清理旧版：卸载 MSI 后删
C:\Go；macOS 上删/usr/local/go并brew uninstall go再重装 - 临时切换：用完整路径调用，例如
/opt/go-1.22.6/bin/go version；长期方案是统一用asdf（macOS/Linux）或gvm（仅 Linux）管理多版本 - 关键点：IDE（如 VS Code）里的 Go 扩展会读
PATH，不是读go env，所以 PATH 顺序决定它用哪个go
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
