go command not found 是 path 未正确配置的直接信号，需确认 go 二进制路径（如 /usr/local/go/bin/go）、将其加入 shell 配置文件（~/.zshrc 或 ~/.bashrc）、执行 source 重载并验证 echo $path。
go command not found 是 PATH 没配对最直接的信号
安装完 Go 后终端敲 go version 报错，基本就是 PATH 没加进 shell 环境变量。系统根本找不到 go 这个可执行文件。
- 先确认 Go 安装路径是否真实存在：比如
/usr/local/go/bin/go或C:\Go\bin\go.exe，用ls -l /usr/local/go/bin/go（Linux/macOS）或dir C:\Go\bin\go.exe（Windows）验证 - Zsh 用户（macOS Catalina+ / 多数新 Linux 发行版）：编辑
~/.zshrc，追加export PATH="/usr/local/go/bin:$PATH" - Bash 用户：改
~/.bashrc或~/.bash_profile，同样加export PATH="/usr/local/go/bin:$PATH" - Windows 用户：「系统属性 → 高级 → 环境变量」→ 在用户或系统
Path里新增C:\Go\bin - 改完必须重载配置：
source ~/.zshrc（或对应文件），再跑一次go version看输出
go get failed to load mod file 常因当前目录缺 go.mod
启用模块模式（GO111MODULE=on）后，go get 默认拒绝在无 go.mod 的目录操作，报错信息就是 failed to load mod file —— 它不是包本身坏了，而是“上下文不合法”。
- 想初始化新项目：先运行
go mod init example.com/myapp（模块名任意，不需真实存在） - 只想装工具（如
gopls、air）：加-d参数跳过构建，例如go install golang.org/x/tools/gopls@latest -d - 误在
$GOPATH/src下执行：Go 1.16+ 已默认禁用 GOPATH 模式，退出该目录，换到空目录再试 - 检查是否意外设置了
GO111MODULE=off：运行go env GO111MODULE确认值为on或auto
GOROOT 设错导致 build 失败但错误信息很模糊
GOROOT 只应指向 Go 安装根目录（如 /usr/local/go），不是项目目录也不是 $HOME/go。设错后常见现象是 go build 报各种“找不到标准库”或“cannot find package"，但没提 GOROOT。
- 查当前值：
go env GOROOT，如果输出明显不对（比如/home/user/go），就说明被覆盖了 - 搜所有 shell 配置文件：
grep -r "GOROOT=" ~/.zshrc ~/.bashrc ~/.profile ~/.bash_profile 2>/dev/null - 删掉类似
export GOROOT=$HOME/go的错误行，然后source对应文件 - 注意 IDE（如 VSCode、GoLand）可能读取项目级
.env或go.env文件，也得一并检查
Windows 下 cgo 报 gcc: not found 别急着装 MinGW
cgo 默认启用时，Windows 编译含 C 代码的包（如 net、某些数据库驱动）会找 gcc，找不到就报错。但多数纯 Go 项目根本不需要 cgo。
- 临时禁用：
CGO_ENABLED=0 go build，适合调试或发布静态二进制 - 真要启用 cgo：装 MinGW-w64（推荐 官方下载页），把
bin加进Path；或直接用 WSL2，环境更干净 - 注意：禁用 cgo 后
net包 DNS 解析会回退到纯 Go 实现（netgo），行为略有差异，生产环境需验证
GOROOT 被手动覆盖、go get 在错误目录执行这两类问题，症状隐蔽但原因固定——盯住 go env 输出和当前工作目录，比猜报错更省时间。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
