答案是path未正确配置、goroot指向错误或go111module未开启。go version报command not found是path未包含$goroot/bin；go env gopath为空属正常（go 1.14+默认模块模式）；go run报cannot find module需先执行go mod init初始化模块；国内需配置goproxy=https://goproxy.cn,direct以解决golang.org/x包拉取失败。
Go 环境装不起来，八成不是下载错了，而是 PATH 没加对、GOROOT 指错了，或者压根没开 GO111MODULE=on —— 这三个点卡住 90% 的新手。
go version 命令报 command not found 怎么办
这是最典型的 PATH 配置失败。安装完 Go 后，go 可执行文件实际在 $GOROOT/bin 目录下（比如 /usr/local/go/bin 或 C:\Go\bin），但系统找不到它。
- Windows：必须手动把
C:\Go\bin（或你自定义的安装路径下的\bin）加进「系统环境变量」里的Path，不是用户变量，也不是随便新建一个叫Path的变量 - macOS/Linux：检查你改的是哪个 shell 配置文件 —— 如果用 zsh（macOS Catalina 及以后默认），得改
~/.zshrc；如果用 bash，才是~/.bash_profile或~/.bashrc；改完必须运行source ~/.zshrc生效 - 验证方式不是看
echo $PATH里有没有那段路径，而是直接新开一个终端窗口，再跑go version—— 很多人在旧终端里反复source却不换窗口，一直失败
go env 显示 GOPATH 是空的，是不是配置错了
不是错，是正常。从 Go 1.14 开始，默认启用 Go Modules，GOPATH 不再强制要求。你现在可以完全不设 GOPATH，只要项目根目录有 go.mod 文件，就能正常 go build 和 go run。
- 如果你执行
go env GOPATH返回空，且go mod init myapp能成功生成go.mod，说明模块模式已就位，不用管GOPATH - 只有当你想用老式
go get（不带-u）往$GOPATH/src下拉包，才需要显式设置GOPATH；现在几乎没人这么干了 -
GOROOT必须正确（指向 Go 安装根目录），但GOPATH留空反而更安全，避免误入旧工作区陷阱
go run hello.go 报错：cannot find module providing package
这是 Go Modules 模式被触发但没初始化的典型错误。Go 1.16+ 默认开启模块模式，一旦当前目录没有 go.mod，又引用了非标准库包（哪怕只是 fmt），就会报这个错 —— 实际上它连 fmt 都找不到，因为模块路径解析失败。
- 解决方法只有一条：
go mod init example.com/hello（随便起个模块名，域名非必需，但推荐用） - 执行后会生成
go.mod文件，里面至少包含module example.com/hello和go 1.24（版本号自动匹配你本地 Go 版本） - 之后再
go run hello.go就能跑通；如果代码里用了第三方包（比如github.com/gin-gonic/gin），go run会自动写进go.sum并下载依赖 - 别试图删掉
go.mod回退到“无模块”状态 —— Go 已不支持那种模式，硬删只会让所有命令失效
国内拉不到 golang.org/x/ 包怎么办
官方代理 https://proxy.golang.org 在国内基本不可用，不配代理就卡在 go get 或 go mod download 上。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.cloud.tencent.com/go/ -
direct表示对私有仓库（如公司内网 Git）跳过代理，直连；没有它，私有包会 404 - 如果公司有 Nexus 或 Artifactory 做 Go 代理，把地址填在
GOPROXY里，多个地址用逗号分隔 - 临时绕过代理只对某个包生效？加
-insecure不安全，不推荐；更稳妥的是用replace在go.mod里重定向路径
真正容易被忽略的，是 go mod init 这一步 —— 它不像 npm init 那样有交互提示，也不报错说“你缺个模块文件”，而是静默失败，直到你看到那个“cannot find module”的错误才意识到问题。很多人花半小时查 PATH、重装 Go，其实只要敲一行命令就解了。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
