Go环境安装后“go: command not found”根本原因是PATH未正确配置，导致shell找不到go可执行文件；需将GOROOT/bin加入对应shell配置文件（如macOS用~/.zshrc）、source生效，并验证echo $PATH含go路径。
Go 环境装不上，八成卡在 PATH 没生效、GOROOT 路径写错，或者 go version 成功但 go run 报 command not found: go —— 这些都不是 Go 本身的问题，是环境变量没串起来。
go version 能跑，但 go run 报错：command not found
这是最典型的“半安装”状态：二进制文件在，但 shell 找不到它。
-
go version成功只说明当前终端 session 里 PATH 临时有效（比如你刚执行过export PATH=$PATH:/usr/local/go/bin），但没写进 shell 配置文件 - 新开一个终端或 VS Code 内置终端就失效，因为
.bashrc或.zshrc里没这行 - Mac 用户尤其注意：macOS Sequoia 默认用
zsh，改.bashrc没用；Linux Ubuntu 22.04+ 同样默认zsh - 验证方式：运行
echo $PATH | grep go，没输出就说明 PATH 没落盘
解决办法：编辑 ~/.zshrc（不是 .bash_profile），追加：
export GOROOT=/usr/local/go export PATH=$PATH:$GOROOT/bin
然后执行 source ~/.zshrc，再开新终端测试 go run。
立即学习“go语言免费学习笔记（深入）”；
go env GOPATH 显示空值或默认路径，但项目编译失败
Go 1.16+ 默认开启模块模式（GO111MODULE=on），GOPATH 对构建已非必需——但它仍影响 go install 输出位置和某些工具链行为。
- 如果你用
go install安装gopls或dlv，它们会默认装到$GOPATH/bin，如果GOPATH是空的，就会报cannot find module providing package -
go env -w GOPATH=$HOME/go可强制设置（不推荐用 root 或系统目录） - VS Code 的
go.gopath设置必须和go env GOPATH输出一致，否则插件找不到gopls - 别把
GOPATH和GOBIN混用：GOBIN是可执行文件安装目录，GOPATH/bin是它的默认值，但可单独覆盖
Linux 下 tar 解压后 go 命令仍不可用
常见于 CentOS/RHEL 或手动解压场景，错误在于权限或路径硬编码。
- 解压命令必须用
sudo tar -C /usr/local -xzf go*.tar.gz，-C指定根目录，否则解出的go文件夹可能嵌套在当前目录下 -
/usr/local/go目录权限需为755，且bin/go有执行权限（ls -l /usr/local/go/bin/go应含x） - 某些最小化安装的 Linux 发行版缺
libc兼容层，运行go version报no such file or directory（实际是动态链接库缺失），执行ldd /usr/local/go/bin/go查依赖，补装glibc或换用静态链接版（如从go.dev/dl下载带musl后缀的包）
VS Code 中 Go 扩展一直显示 “Loading…” 或无法跳转定义
根本原因通常是 gopls 没装上或版本不匹配，而不是插件本身问题。
- 不要依赖插件自动安装：关闭 VS Code，终端运行
go install golang.org/x/tools/gopls@latest（注意是@latest，不是@master） - 确认安装成功：
which gopls应输出类似/home/xxx/go/bin/gopls；若为空，检查GOBIN是否设对 - VS Code 设置里关掉
go.useLanguageServer再打开，强制重连 - 项目根目录必须有
go.mod文件（哪怕只是go mod init example.com/foo），否则gopls不激活语义分析
真正麻烦的从来不是下载和解压，而是环境变量之间那几条看不见的连接线——漏掉任意一环，go 就变成一个能打印版本号却干不了别的“哑巴命令”。
