根本原因是系统未将go二进制目录加入$path；macos/linux需在~/.zshrc或~/.bash_profile中添加export path=$path:/usr/local/go/bin并source生效，windows需在系统环境变量path中添加%goroot%\bin或完整路径。
go version 报 command not found 怎么办
根本原因只有一个：系统没把 go 二进制所在目录加进 $PATH。不是安装失败，是 shell 找不到它。
- macOS/Linux：确认 Go 解压路径（通常是
/usr/local/go），在~/.zshrc或~/.bash_profile末尾加一行：export PATH=$PATH:/usr/local/go/bin，然后运行source ~/.zshrc - Windows：右键“此电脑”→属性→高级系统设置→环境变量→编辑“系统变量”里的
Path→新增%GOROOT%\bin（前提是已设好GOROOT）或直接填完整路径，如C:\Program Files\Go\bin - 验证必须新开一个终端窗口执行
go version，旧窗口不会自动继承新 PATH
GOBIN 设置后 go install 还是找不到命令
常见于想装 gopls、delve 等工具却提示 “command not found”，本质是 GOBIN 没生效或路径不存在。
- 先确保目录存在：
mkdir -p $HOME/go/bin（Linux/macOS）或mkdir %USERPROFILE%\go\bin（Windows） - 显式导出：
export GOBIN=$HOME/go/bin，并把它加进 shell 配置文件（和 PATH 同一文件） -
GOBIN必须出现在PATH前面，推荐写法：export PATH=$GOBIN:$PATH，否则即使装进去了也优先找到系统里旧版本 - 执行
go install golang.org/x/tools/gopls@latest后，用which gopls（macOS/Linux）或where gopls（Windows）确认是否落在$GOBIN下
go run 能跑，go build 出来的二进制一运行就 panic: failed to initialize module
这不是环境变量问题，而是构建时缺失模块上下文——典型症状是用了 embed 或 runtime/debug.ReadBuildInfo() 却在非模块根目录下构建。
- 必须在有
go.mod的目录下执行go build，不能 cd 进某个子目录再 build - 如果项目结构是
project/cmd/myapp/main.go，构建命令得在project/目录下运行：go build -o myapp ./cmd/myapp - CI 或脚本中容易忽略当前工作目录（cwd），建议显式加
cd $(dirname $(realpath $0))/..切到模块根再构建 -
go env GOMOD返回空字符串？说明当前不在模块内，立刻检查go.mod位置和 cwd
VS Code 里 gopls 报错或 package main 爆红
多数情况是 Go 扩展找不到模块元信息，或代理/模块模式配置不一致。
- 先运行
go mod init example.com/myproject（随便起个模块名）生成go.mod，哪怕只是临时测试 - 确保
GO111MODULE是on：go env -w GO111MODULE=on，关掉或 auto 容易在 IDE 启动时被 cwd 干扰 - 国内用户必须配代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则gopls初始化会卡住或失败 - VS Code 中按
Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），搜 “Go: Install/Update Tools”，全选安装，别点单个工具
最常被忽略的一点：环境变量只对当前 shell 会话生效，而 VS Code 可能从桌面环境启动，根本不读你的 ~/.zshrc。macOS 用户需用 code --new-window 从终端启动 VS Code，Windows 用户注意 PowerShell 和 CMD 的环境变量隔离。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
