go version报“command not found”是PATH未生效所致，需确认go二进制路径（如/usr/local/go/bin或C:\Go\bin）已加入PATH，并重启终端或source配置文件验证。
Go 环境搭建本身不难，但新手常卡在环境变量配置、版本切换和代理设置这三处——不是装不上，而是装完 go version 报错或 go run 找不到模块。
验证安装后 go version 报 “command not found” 怎么办
这是 PATH 没生效的典型表现，和安装是否成功无关。重点检查两件事：
-
go二进制实际位置：Windows 默认是C:\Program Files\Go\bin，macOS 是/usr/local/go/bin，Linux 多为/usr/local/go/bin或/usr/lib/go/bin；用where go（Windows）或which go（macOS/Linux）确认 - PATH 是否真正加载：终端重启后，运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），看输出里有没有上面那个bin路径；没出现就说明配置没生效，别信“已保存”，要重开终端或手动source ~/.zshrc - 别把
GOROOT和GOPATH混在一起配：现在 Go 1.16+ 默认启用 Go Modules，GOROOT是 Go 安装路径（一般不用手动设），GOPATH只影响go install到$GOPATH/bin的行为，日常开发可完全不管它
Windows 用户用 winget install Go 后仍无法运行 go mod init
winget 安装的 Go 版本可能较旧（如 1.21.x），而某些模块依赖要求 Go 1.22+；更关键的是 winget 不自动配置 GOPROXY，国内用户首次运行 go mod init 会卡死在拉取 golang.org/x/... 包上。
- 优先改用官网 .msi 安装包：它会自动写入系统 PATH 并设置好默认代理（Go 1.22+ 内置
https://proxy.golang.org） - 若坚持用 winget，装完立刻执行：
go env -w GOPROXY=https://goproxy.cn,direct（推荐goproxy.cn，比官方代理在国内更稳） - 验证代理是否生效：
go env GOPROXY输出应为上面那串地址，不是direct或空
macOS 上用 Homebrew 装完 Go，go run main.go 提示 “cannot find module”
这不是环境问题，是项目没初始化模块——Go 1.16+ 默认强制使用 Go Modules，不能直接在任意目录下跑 go run。
立即学习“go语言免费学习笔记（深入）”；
- 必须先在项目根目录执行：
go mod init myproject（myproject是模块名，一般用 GitHub 路径如github.com/you/myproject） - 执行后会生成
go.mod文件，此时再go run main.go才能正常解析依赖 - 别在
~/go/src/下硬套旧式 GOPATH 结构：现在go mod已取代它，随意建src目录反而容易触发错误的 vendor 查找逻辑
Linux 用户解压 tar.gz 后 go build 编译失败，提示 “no required module provides package”
常见于从源码或非标准路径安装 Go，导致 GOROOT 指向错误或标准库缺失。
- 检查
go env GOROOT：输出应为你解压的路径（如/usr/local/go），如果显示空或错位，手动设：go env -w GOROOT=/usr/local/go - 确认
/usr/local/go/src目录存在且非空：缺失则说明解压不完整，重新tar -C /usr/local -xzf go*.tar.gz - 避免用
sudo apt install golang-go：Ubuntu 官方源的 Go 版本通常滞后 2~3 个小版本，且自带的GOROOT可能指向/usr/lib/go，与实际安装冲突
最易被忽略的一点：所有配置命令（go env -w）写入的是用户级环境，不是系统级；换用户或用 sudo 运行时，这些设置不继承——调试时尽量别切 root，用普通用户全程操作。
