Go命令提示“command not found”是因PATH未包含Go安装路径的bin目录，需确认安装路径存在go可执行文件，并将对应bin目录加入PATH后重载配置。
go命令提示“command not found”
这是最表层也最容易被忽略的问题：系统根本没找到go这个可执行文件。不是Go没装好，而是它被“藏起来了”。
- 先确认安装路径是否存在
go（或go.exe）：Linux/macOS 运行ls -l /usr/local/go/bin/go，Windows 用资源管理器打开C:\Go\bin看有没有go.exe - PATH 必须包含该
bin目录：Zsh 用户加export PATH=$PATH:/usr/local/go/bin到~/.zshrc；Windows 在「环境变量」里把C:\Go\bin加进 Path - 改完别忘了重载：Zsh 执行
source ~/.zshrc，Windows 必须**新开一个终端**——旧窗口不会读新环境变量 - 如果用 Homebrew 安装过 Go，再手动解压覆盖，容易导致
which go指向旧路径，建议删掉/usr/local/go并brew reinstall go
go version能运行但go get失败
说明基础环境通了，但模块链路断在下载环节，国内用户十有八九卡在这一步。
- 错误典型如：
go: failed to download golang.org/x/net v0.0.1: Get https://proxy.golang.org/: dial tcp: i/o timeout - 必须显式启用模块：
export GO111MODULE=on（Go 1.16+ 默认开启，但某些旧 shell 配置可能覆盖） - 代理必须设对且带
direct回退：export GOPROXY=https://goproxy.cn,direct，漏掉,direct会导致私有模块拉取失败 - 若用公司内网 Git（如
git.company.com），加export GOPRIVATE=git.company.com跳过代理
GOROOT和GOPATH设置冲突
这两个变量现在多数场景下已非必需，但一旦设错，反而会干扰工具链行为，尤其在多版本共存或编辑器集成时。
-
go env GOROOT输出应与你实际安装路径一致；若输出空或错误路径，说明GOROOT被错误声明，直接删掉该环境变量更安全 -
GOPATH在纯 Go Modules 项目中可不设；若设了，确保目录存在且可读写：mkdir -p $HOME/go，否则go install的二进制会写入失败 - VS Code 或 GoLand 报
gopls not found，大概率是$GOPATH/bin没进 PATH，或go install golang.org/x/tools/gopls@latest装到了别的地方
架构不匹配导致go命令静默失败
尤其在 Apple Silicon（M1/M2/M3）Mac 或老旧 Windows 上，选错二进制包会让 go 命令看起来“能运行但没反应”，连 go version 都卡住或直接退出。
立即学习“go语言免费学习笔记（深入）”；
- 查当前系统架构：
uname -m（Linux/macOS）或echo %PROCESSOR_ARCHITECTURE%（Windows） - M1/M2/M3 Mac 必须用
darwin/arm64版本，不是darwin/amd64；32 位 Windows 要用386包，64 位才用amd64 - 验证方式：运行
/usr/local/go/bin/go version（完整路径），若报Bad CPU type in executable就是架构错
真正卡住人的从来不是某一行命令，而是多个环节叠加失效：PATH 没生效 + 代理没配 + 架构选错，三者同时发生时，go version 成功反而会误导你认为“环境没问题”。排查时务必拆开验证，别跳步。
