VSCode中go命令报“command not found”是因为其未继承shell环境变量：macOS/Linux从图标启动时不加载~/.zshrc等配置，Windows图形界面启动不读用户PATH；需从终端执行code启动、验证which go输出，并确保PATH包含Go的bin目录。
为什么go命令在终端里能用，VSCode里却报“command not found”
这不是Go没装好，是VSCode没读到你的shell环境变量。macOS和Linux下从桌面图标或Spotlight启动VSCode时，它不加载~/.zshrc或~/.bash_profile，PATH还是初始值。
验证方法：在系统终端运行which go，有输出说明Go本身没问题；再打开VSCode内置终端，执行同样命令——如果没输出，就是环境没继承。
- 最稳解法：关掉VSCode，从终端执行
code .启动项目，这样它会复用当前shell的PATH - macOS用户注意Homebrew安装路径：Apple Silicon是
/opt/homebrew/bin/go，Intel是/usr/local/bin/go，别只配/usr/local/go/bin - Windows用户若用PowerShell启动VSCode，需确认
$env:PATH里包含$env:GOROOT\bin，且重启VSCode（不是重开窗口）
go env GOROOT返回空或错路径，说明GOROOT被设错了
GOROOT不是可选配置项，它是Go工具链定位自身标准库和编译器的锚点。设错会导致go build找不到runtime包、go test崩溃，甚至go mod download静默失败。
常见错误场景：
立即学习“go语言免费学习笔记（深入）”；
- 手动解压安装后，在
~/.zshrc里写了export GOROOT=/usr/local/go，但实际解压到了$HOME/sdk/go - 用
apt install golang装完又手写GOROOT，结果APT包默认不设GOROOT，靠go二进制自发现路径，你一覆盖反而破坏逻辑 - 多版本共存时，
GOROOT指向旧版目录，但PATH里新版go先被找到，版本错乱
修复建议：先删掉所有export GOROOT=...行，运行go env GOROOT看它自己报什么；如果为空，再根据安装方式补——源码编译必须设，APT安装通常不用设，官方二进制包按解压路径设。
统信UOS或国产信创系统上go command not found要过五关
信创环境不是单纯PATH问题，得同步处理权限、源策略、模块代理三重约束。
典型卡点：
-
apt install golang后go version仍报错：检查/etc/apt/sources.list每行末尾是否含non-free，缺了就装不上完整工具链 - 手动解压后
source /etc/profile无效：UOS默认用dash而非bash解析/etc/profile，得改用source /etc/environment或切到bashshell -
go mod download超时：必须立刻执行go env -w GOPROXY=https://goproxy.cn,direct，国内镜像不设等于没法拉依赖 - 非root用户执行
go run失败：UOS默认禁用user_namespaces，得先sudo sysctl user.max_user_namespaces=10000
Linux源码编译Go后go命令找不到？重点查GOBIN和make.bash执行状态
源码编译不像二进制包解压即用，它必须运行src/make.bash生成go可执行文件，且默认输出到$GOROOT/bin——如果GOBIN另设了路径，而PATH没跟上，就必然找不到。
操作确认清单：
- 编译前确保
GOROOT已导出，且cd $GOROOT/src能进入源码目录 - 执行
./make.bash后，检查$GOROOT/bin/go是否存在且有执行权限：ls -l $GOROOT/bin/go - 若
GOBIN指向/usr/local/bin，但PATH里只有/usr/local/go/bin，那肯定找不到 - 某些Linux发行版（如CentOS Stream）默认禁用
gcc的-fPIE选项，编译会卡在runtime/cgo，需先export CGO_ENABLED=0再跑make.bash
最易忽略的一点：make.bash成功不代表go可用——它可能只生成了6g等底层工具，而没生成顶层go命令，此时要检查$GOROOT/src/cmd/go目录是否存在且可读。
