最常见原因是path未正确配置，而非go未安装；需确认go二进制路径（如/usr/local/go/bin/go），将对应bin目录加入path，修改shell配置文件（如~/.zshrc）并source生效，再验证echo $path是否包含该路径。
go command not found：PATH没加对
这是最常见现象，不是没装Go，而是系统压根找不到go命令。先确认Go二进制真实位置：ls /usr/local/go/bin/go（Linux/macOS）或dir C:\Go\bin\go.exe（Windows）。PATH必须包含/usr/local/go/bin或C:\Go\bin，不能只加/usr/local/go。
Zsh用户改~/.zshrc，Bash用户改~/.bashrc，写完必须source ~/.zshrc；验证是否生效：echo $PATH | grep -o "/usr/local/go/bin"应有输出。
cannot find main module：模块没初始化
运行go run main.go报这个错，说明当前目录不在Go模块内。这不是安装问题，是操作遗漏——执行go mod init example.com/test（模块名任意，合法即可），会生成go.mod文件。
不初始化也能跑单文件，但一旦用到第三方包、想go build或后续扩展，模块就是必需的；如果项目在$GOPATH/src下，Go会退化为旧模式，建议把项目放在~/projects/这类路径，再go mod init。
cgo: C compiler "gcc" not found：缺少C编译器
用到cgo（比如调用系统库、SQLite、OpenSSL）时，Go会尝试调用gcc，报这个错说明系统没装C工具链。
- Ubuntu/Debian：
sudo apt install build-essential - CentOS/RHEL：
sudo yum groupinstall "Development Tools"或dnf groupinstall "Development Tools" - macOS：
xcode-select --install - Windows：装MinGW-w64，把
bin目录加进PATH，再验证gcc -v
装完后go env -w CGO_ENABLED=1确保启用（默认开启，但某些环境可能被关掉）。
go: failed to download：国内网络超时
执行go mod tidy或go get卡住、报dial tcp: i/o timeout，基本是代理没开。
必须设两件事：go env -w GO111MODULE=on（强制启用模块）go env -w GOPROXY=https://goproxy.cn,direct（推荐七牛镜像）
私有仓库加：go env -w GOPRIVATE=git.example.com
调试时可临时关校验：go env -w GOSUMDB=off，但上线前务必恢复。
真正安装失败极少见——只要go version能输出，99%的问题都出在PATH、模块初始化、C工具链或代理配置这四点上；每个错误背后其实对应一个明确动作，而不是模糊的“重装”。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
