答案是依次验证go version输出、go env goroot/gopath路径有效性、go mod init能否生成go.mod文件；需确保path包含$goroot/bin、shell配置已source生效，且模块初始化正确，三者缺一不可。
Go 语言环境搭不起来，后面所有代码都跑不起来——不是版本冲突就是 GOROOT 或 GOBIN 配错，最常见的是 go 命令根本找不到。
怎么验证 Go 是否真装好了，而不是“看似成功”
很多人执行完安装脚本就以为完事了，但 go version 能运行不代表开发环境可用。关键要测三件事：
- 终端里输入
go version，必须输出类似go version go1.22.3 darwin/arm64的完整信息（不含command not found） - 运行
go env GOROOT和go env GOPATH，确认路径不为空且指向实际目录（比如/usr/local/go、$HOME/go） - 新建一个空目录，执行
go mod init example.com/test，能生成go.mod文件才算模块系统就绪
如果 go env 显示的 GOPATH 是空或 ~/go 以外的路径，大概率是 shell 配置没生效，别急着重装，先检查 ~/.zshrc 或 ~/.bash_profile 里是否漏加了 export PATH=$PATH:$GOROOT/bin:$GOPATH/bin。
Mac M 系列 / Windows WSL 下最容易卡住的 PATH 问题
Apple Silicon Mac 默认用 zsh，但很多教程还教改 ~/.bash_profile，结果配置根本加载不上；WSL 则常因 Windows 和 Linux 两套环境混用，导致 go 在 PowerShell 里能用，在 WSL 终端里却报错。
- Mac 用户：用
echo $SHELL确认当前 shell，然后只改对应文件（zsh →~/.zshrc，bash →~/.bashrc） - WSL 用户：不要在 Windows 的 PowerShell 里配 Go，所有操作都在 WSL 终端内完成；安装时用
sudo apt install golang-go（Ubuntu）比手动下载二进制更省事，且自动处理 PATH - 改完配置必须执行
source ~/.zshrc（或对应文件），不能只关掉再开个新终端——有些终端不会自动 reload
go run main.go 报错 “cannot find module providing package” 怎么办
这不是 Go 没装好，而是模块初始化缺失。Go 1.16+ 默认启用 module 模式，没 go.mod 就不认当前目录为项目根。
- 进入项目目录后，第一件事永远是
go mod init your-module-name（名字不用真实域名，但不能含空格或大写字母） - 如果已有
go.mod但报这个错，说明import的包路径和go.mod里声明的模块名不一致，比如go mod init myapp，但代码里写了import "github.com/xxx/myapp" - 临时绕过模块检查？可以加
-mod=mod参数：go run -mod=mod main.go，但这是权宜之计，上线前必须修复模块声明
真正麻烦的不是装 Go，而是不同终端、不同 shell、不同操作系统对环境变量的加载逻辑不一致——哪怕 go version 成功了，也可能在 VS Code 的集成终端里失效，这时候得去检查编辑器的 shell 设置是否匹配你手动配置的 shell 类型。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
