go version命令不识别是因为PATH未包含Go的bin目录；Windows需确认安装路径是否为C:\Program Files\Go\bin，macOS/Linux常误写为/usr/local/go（漏/bin）；应通过echo $PATH或echo %PATH%验证，临时用export或$env:PATH添加，永久配置需修改~/.zshrc等并source或重启终端。
go version 命令不识别，PATH 没配对
执行 go version 报错 command not found 或 'go' is not recognized as an internal or external command，基本就是 PATH 里没包含 Go 的 bin 目录。
Windows 用户常见错误是只加了 C:\Go\bin，但实际安装路径可能是 C:\Program Files\Go\bin（尤其用 MSI 安装时）；macOS/Linux 用户常把 /usr/local/go/bin 写成 /usr/local/go（漏了 /bin）。
- 验证方法：运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出中包含完整bin路径 - 临时修复：在当前终端手动加，比如 macOS/Linux 执行
export PATH=$PATH:/usr/local/go/bin；Windows PowerShell 执行$env:PATH += ";C:\Program Files\Go\bin" - 永久生效必须重载配置文件（
~/.zshrc、~/.bash_profile或 Windows 系统变量），改完记得重启终端或运行source ~/.zshrc
GOROOT 和 GOPATH 不该手动设，除非有特殊需求
Go 1.16+ 默认启用 GO111MODULE=on，且现代项目几乎都用 Go Modules。此时 GOROOT 由安装程序自动确定，GOPATH 仅用于存放 pkg 和 bin（如 go install 生成的可执行文件），不再影响项目源码位置。
手动设置 GOROOT 可能导致 go build 找不到标准库；乱设 GOPATH 会让 go get 下载的依赖和工具混进旧目录，与模块路径冲突。
立即学习“go语言免费学习笔记（深入）”；
- 检查是否被误设：运行
go env GOROOT GOPATH，正常情况下GOROOT是安装路径，GOPATH是用户家目录下的go文件夹（如/home/username/go） - 如果没动过环境变量，就别碰它们；如果已设错，直接从系统/用户环境变量中删掉这两项，重启终端即可恢复默认
-
GOBIN可以设（比如指向$HOME/bin），但要确保它也在PATH里，否则go install出的命令找不到
go run hello.go 失败，main 包或函数名写错了
新手常把 hello.go 写成：
package main<br>import "fmt"<br>func Main() { // 错：首字母大写<br> fmt.Println("Hello, Go!")<br>}
或漏掉 package main，或把文件放在 $GOPATH/src 下却没按包路径组织目录——这些都会让 go run 报 no Go files in current directory 或 undefined: main。
-
main函数必须全小写：func main()，且必须在package main中 - 文件可以放在任意目录（不必在
GOPATH内），只要当前目录下只有 .go 文件且含合法main函数 - 如果同时有多个 .go 文件，全部都要参与编译，比如
go run *.go或指定全部文件名 - 避免用中文路径或空格路径，Windows 尤其容易因路径含空格导致
go工具解析失败
国内用户 go mod download 卡住或超时
执行 go mod tidy 或首次 go run 含第三方依赖的代码时，卡在 “Fetching …” 或报 timeout，大概率是模块代理不可用或没设。
Go 默认从 proxy.golang.org 拉模块，国内直连不稳定。不能只靠 git config --global http.https://goproxy.io.sslVerify false 这类过时方案——现在主流代理已换。
- 推荐设置：运行
go env -w GOPROXY=https://proxy.golang.com.cn,direct（官方认可的中文镜像）或https://goproxy.cn,direct - 加
,direct表示对私有域名（如公司内网模块）直连，不走代理 - 如果企业有自建代理，用
go env -w GOPROXY=http://your-proxy:8080，并确保该地址可从本地访问 - 临时关闭代理调试：
go env -w GOPROXY=direct，但仅限能直连公网的环境
模块代理不是一劳永逸的，不同时间点可用性会变，遇到拉不下来，第一反应应该是换一个代理地址，而不是反复 clean 或重装 Go。
