go version报command not found是PATH未包含Go的bin目录所致；需确认/usr/local/go/bin（macOS/Linux）或C:\Go\bin（Windows）已加入PATH，并source配置或重启终端验证。
go version 命令没反应，PATH 没配对
安装完 Go 后执行 go version 报 command not found，本质是系统找不到 go 二进制文件。这不是安装失败，而是 PATH 没把 Go 的 bin 目录加进去。
常见错误操作包括：
- 只改了
~/.bashrc却用的是zsh（macOS 默认），结果source ~/.bashrc完全无效 - 写错路径，比如把
/usr/local/go/bin写成/usr/local/go或漏掉/bin - 没生效配置：改完配置文件后忘记运行
source ~/.zshrc（或对应 shell 配置文件）
验证方式很简单：ls /usr/local/go/bin/go（Linux/macOS）或 dir C:\Go\bin\go.exe（Windows）确认文件存在；再运行 echo $PATH 看输出里是否含该路径。
GO111MODULE=on 和 GOPROXY 必须设，否则 go mod init 失败
Go 1.11 起默认启用模块（module）模式，但旧教程常忽略这两项配置。不设 GO111MODULE=on，go mod init 会静默失败或退化为 GOPATH 模式；不设 GOPROXY，国内用户 go get 几乎必卡在 proxy.golang.org。
立即学习“go语言免费学习笔记（深入）”；
推荐直接追加到 shell 配置文件：
echo 'export GO111MODULE=on' >> ~/.zshrc echo 'export GOPROXY=https://goproxy.cn,direct' >> ~/.zshrc source ~/.zshrc
注意：direct 是 fallback，表示当代理不可用时直连原始地址；goproxy.cn 是国内稳定镜像，比 goproxy.io 更可靠。
写完 hello.go 后 go run 报错：package main is not in GOROOT
这个错误不是代码问题，而是当前目录结构不符合 Go 模块预期。Go 不再强制要求项目放在 $GOPATH/src 下，但必须有 go.mod 文件，且 go run 执行的 .go 文件需属于 package main 且所在目录能被模块识别。
正确流程只有三步：
- 新建空目录：
mkdir ~/hello && cd ~/hello - 初始化模块：
go mod init hello（模块名可任意，只要合法） - 写
hello.go，开头必须是package main，且含func main()
如果跳过 go mod init 直接 go run hello.go，Go 会尝试从 GOROOT 查找 main 包——显然找不到，于是报这个误导性错误。
go test 运行失败，提示 cannot find package "testing"
这通常发生在手动解压 Go 安装包但未正确设置 GOROOT 时。虽然 go version 能跑，但 go test 依赖标准库路径，而 Go 工具链默认从 $GOROOT/src 加载 testing 等包。
检查方法：go env GOROOT 输出是否为空或错误；再看 ls $(go env GOROOT)/src/testing 是否存在。
修复方式（Linux/macOS）：
echo 'export GOROOT=/usr/local/go' >> ~/.zshrc source ~/.zshrc
Windows 用户若用 ZIP 方式安装，需手动在系统环境变量中添加 GOROOT，值为 Go 解压目录（如 C:\Go），并确保 %GOROOT%\bin 在 PATH 中。
最容易被忽略的是：Go 1.22 默认启用 GOEXPERIMENT=fieldtrack 等实验特性，某些老旧 CI 环境或 Docker 镜像可能未同步更新，导致 go build 报未知 flag 错误——此时应显式指定 GOEXPERIMENT= 清空，而非降级 Go 版本。
