“go version报command not found”说明PATH未配置，需将Go二进制路径（如/usr/local/go/bin）加入shell配置文件并source生效；macOS M1/M2须用darwin-arm64包；Windows和Linux手动安装后必须自行配置PATH。
go version 命令报错：command not found
说明你根本没把 go 加进系统 PATH，安装只是完成了“下载解压”，没完成“可用”。Windows 和 macOS 安装包通常自动配置好，Linux 手动安装后必须自己加。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 检查
go二进制是否真在磁盘上，比如/usr/local/go/bin/go； - 确认 shell 配置文件（
~/.bashrc、~/.zshrc或~/.profile）里有这行：export PATH=$PATH:/usr/local/go/bin； - 改完后别忘了执行
source ~/.zshrc（或对应文件），否则新开终端才生效； - 如果用的是 macOS M1/M2，注意下载的是
darwin-arm64版本，别混用amd64包——否则go version会直接报cannot execute binary file。
go mod init 报错：unknown revision v0.0.0
这是典型的 GOPROXY 没生效导致的依赖拉取失败。Go 1.13+ 默认启用代理，但某些网络环境或公司内网会拦截或绕过它，结果 go mod init 后首次 go build 或 go run 就卡住、报错。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://proxy.golang.org,direct（官方代理）； - 国内用户可换为
https://goproxy.cn或https://mirrors.aliyun.com/goproxy/； - 若公司有私有代理，需配成
https://your-company-goproxy.example.com,direct； - 加
,direct是关键：它表示当代理返回 404 时 fallback 到直连，避免私有模块拉不到。
VS Code 提示 “Go extension not activated” 或无法跳转定义
不是插件没装，而是 VS Code 没识别出当前是 Go 项目——它依赖 go.mod 文件或 GOROOT 环境变量来激活语言服务。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确保项目根目录下有
go.mod（哪怕只是空文件，go mod init example就能生成）； - 检查
GOROOT是否设置正确：运行go env GOROOT，输出应是非空路径，且该路径下有src、bin目录； - VS Code 设置里搜
go.goroot，手动填入go env GOROOT的输出值； - 重启 VS Code —— 插件不会自动重载语言服务器，关再开最稳。
go build 生成的二进制在另一台机器上运行失败
默认编译出来的程序是动态链接 libc 的，换到不同发行版（比如从 Ubuntu 编译、放到 Alpine 运行）就可能提示 not found 或 no such file or directory，尤其 Docker 场景下高频出现。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 加
-ldflags '-s -w'减小体积、去掉调试信息； - 交叉编译前先设环境变量：
CGO_ENABLED=0，再执行go build，这样生成纯静态二进制； - 如果必须用 CGO（比如调 C 库），那就得在目标环境里装对应开发包，比如 Alpine 要
apk add g++ musl-dev； - 验证是否静态：用
file yourbinary看输出里有没有statically linked。
