根本原因是PATH未包含Go的bin目录，导致shell找不到go命令；Mac/Linux需将/usr/local/go/bin、Windows需将C:\Go\bin加入PATH，并用which go或where go验证路径，改配置后须新开终端或重启VS Code。
高薪开发者不靠“一键安装”或“教程照抄”，而是清楚每个环境变量谁在读、谁在写、谁可以删——go version 能跑 ≠ 环境就稳，真正卡住人的永远是 go install 生成的命令找不到、gopls 提示包不存在、go mod tidy 拉不到私有模块。
go version 报 command not found 的真实原因
不是没装 Go，而是 shell 根本没看到 go 这个可执行文件。Mac/Linux 默认解压到 /usr/local/go，但 /usr/local/go/bin 不在 $PATH 里；Windows 安装器若没勾选 “Add to PATH”，C:\Go\bin 就只是个安静的文件夹。
- 验证方式不是只跑
go version，必须补一句which go（macOS/Linux）或where go（Windows），看输出路径是否指向你刚装的目录 - 加 PATH 时注意：加的是
/usr/local/go/bin，不是/usr/local/go；Windows 是C:\Go\bin，不是C:\Go - 改完配置后，别只
source ~/.zshrc，还要新开一个终端验证 —— VS Code 终端可能缓存旧环境，得关掉重开
GOROOT 什么时候真要设
95% 的情况不用碰 GOROOT。官方安装包自带的 go 二进制会自动推导它；设错反而让 go build 找不到 fmt 这类标准库，报 cannot find package "fmt"。
- 唯一需要显式设置的场景：你手动解压了多个 Go 版本（比如
/opt/go1.20、/opt/go1.22），又不想改PATH切换版本 - 检查是否已误设：
go env GOROOT输出应该和which go的上级目录一致（例如which go是/opt/go1.22/bin/go，那么GOROOT应该是/opt/go1.22） - 不一致？直接删掉
GOROOT环境变量，别硬调
go mod init 报 malformed module path 怎么救
这不是语法错误，是模块路径违反 Go 的语义规则：不能用本地绝对路径（如 go mod init /home/user/myproj），不能含大写字母或下划线（如 go mod init My_Project），也不能空着（go mod init 不带参数）。
立即学习“go语言免费学习笔记（深入）”；
- 正确写法是虚拟导入路径，格式为
域名反写 + 项目名，例如go mod init github.com/yourname/cli-tool或go mod init example.com/internal - 哪怕代码不上传 GitHub、不托管任何地方，也建议按这个格式写 —— 否则后续加依赖、用
go run加载子命令、对接私有代理时全都会断 - 本地快速测试可用占位符
go mod init local，但所有import必须严格匹配，且绝不能提交到共享仓库
VS Code 里 gopls 一直报 package not found
根本不是插件坏了，是编辑器没找到 gopls 可执行文件，或者它启动时读错了 GOROOT/GOPATH。
- 先手动装一次：
go install golang.org/x/tools/gopls@latest，确认生成的二进制在$GOPATH/bin/gopls - 再检查 VS Code 设置里
"go.goroot"和"go.gopath"是否为空 —— 现代插件通常自动探测，填了反而覆盖 - 最关键的一步：重启 VS Code 窗口（不是重载，是彻底关掉再开），否则 LSP 进程仍拿着旧环境变量跑
最常被跳过的动作是：改完环境变量后没验证 which go 和 go env，就直接写代码；还有人把 gopls 装在非 $GOPATH/bin 目录，却指望编辑器自动发现。这些点不卡死，后面所有依赖、调试、CI 构建都会反复出同样问题。
