“go: command not found”表明Go已安装但shell无法定位二进制文件，主因是PATH未包含Go的bin目录（如/usr/local/go/bin或C:\Go\bin），或GOROOT配置错误；需检查shell配置文件、正确添加PATH并source生效。
go command not found 是最直接的信号
这不是 Go 没装，而是 shell 找不到 go 二进制。常见原因只有两个：PATH 里漏了 /usr/local/go/bin（macOS/Linux）或 C:\Go\bin（Windows），或者你改过 GOROOT 却指向了错误路径。
先运行 which go（macOS/Linux）或 where go（Windows），如果没输出，说明 PATH 没生效；如果输出路径异常（比如 /home/user/go/bin/go），说明 GOROOT 被手动设错。
- 检查
~/.zshrc（macOS/Linux 默认）或~/.bashrc，确认有类似export PATH="/usr/local/go/bin:$PATH"的行，且没有重复或拼写错误 - 删掉所有手动写的
export GOROOT=...—— 官方安装包会自动推导，硬设反而容易出错 - 改完配置后必须执行
source ~/.zshrc（或对应文件），关掉终端再重开也行，但别跳过这步
go version 正常但 go mod init 失败
这说明 Go 本身可用，但模块系统被干扰。典型表现是报 go: modules disabled 或 cannot find module providing package。
根本原因是 GO111MODULE 被关了，或者当前目录在旧式 $GOPATH/src 下触发了兼容模式。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 运行
go env GO111MODULE，如果不是on，立刻执行go env -w GO111MODULE=on - 别在
$GOPATH/src目录下初始化新项目 —— 现代 Go 不需要它，进任意空目录再go mod init example.com/foo - 如果项目已有
go.mod但依赖拉不下来，大概率是代理失效，运行go env -w GOPROXY=https://goproxy.cn,direct
VS Code 提示 “gopls not installed” 或代码无提示
这不是 Go 环境问题，而是编辑器插件没拿到工具链。VS Code 的 Go 扩展会在首次打开 .go 文件时弹窗提示安装，但有时静默失败或被拦截。
手动触发最可靠：打开命令面板（Cmd+Shift+P 或 Ctrl+Shift+P），输入 Go: Install/Update Tools，全选并安装。
- 确保
GOBIN没被设成奇怪路径，否则工具会装到看不见的地方；可临时清空：go env -u GOBIN - 如果卡在下载
gopls，检查是否用了公司代理或防火墙策略 —— 直接终端运行go install golang.org/x/tools/gopls@latest看报什么错 - 装完后重启 VS Code，别只重载窗口
多个 Go 版本共存时切换混乱
官方安装包覆盖安装会破坏旧版本，而 go version 只显示当前 PATH 里的那个。想快速恢复某个旧版本，不能靠“卸载重装”，得靠路径隔离。
推荐用 go install 方式管理多版本：下载不同版本的 .tar.gz，解压到各自目录（如 ~/sdk/go1.19、~/sdk/go1.22），然后通过 alias 切换：
alias go119='~/sdk/go1.19/bin/go' alias go122='~/sdk/go1.22/bin/go'
- 别把多个版本的
bin同时加进PATH，否则go命令永远调用第一个 - 项目级指定版本：在项目根目录放
go.work或用go version注释声明，但实际执行仍依赖 shell 当前go命令 - 真正要“恢复”某个旧环境，只需改 alias 并
source配置，比重装快十倍
source 或新开终端 —— 这一步跳过，后面所有操作都白忙。 
