go version检查失败说明PATH未正确配置，需确认Windows中Path是否含%GOROOT%\bin或macOS/Linux中$PATH是否含$GOROOT/bin，否则系统无法识别go命令。
go version 检查失败，说明环境根本没搭好
别急着写代码，先确认 go 命令是否真能用。打开终端执行 go version，如果报错 command not found 或类似提示，说明 PATH 没配对——哪怕你装了 Go，系统也找不到它。
- Windows：检查系统环境变量里
Path是否包含%GOROOT%\bin（如C:\Go\bin）或完整路径 - macOS/Linux：运行
echo $PATH看输出里有没有/usr/local/go/bin或你自定义的$GOROOT/bin；没看到就补上，比如在~/.zshrc末尾加export PATH=$PATH:/usr/local/go/bin，再source ~/.zshrc - 别信“安装完自动配置”——Mac 上 .pkg 安装器有时漏写
PATH，Linux 手动解压更常出这问题
go mod init 后 go run 仍报 missing module error
这是新手最常卡住的地方：项目目录下执行了 go mod init myapp，但 go run main.go 还是提示找不到包或依赖错误。根本原因不是命令写错，而是当前路径不在模块根目录下。
- 确保你在
go.mod文件所在目录执行go run，不是它的子目录（比如src/或cmd/下） -
go run默认只找当前目录下的main.go；如果main.go在子目录（如cmd/myapp/main.go），必须显式指定路径：go run cmd/myapp/main.go - 如果项目有多个
main包（比如 CLI 和 server 分开），go run .会失败——Go 不允许模糊匹配，得明确指向文件
想保存编译结果，但 go build -o 不生效
go build -o 看似简单，但输出路径、权限、扩展名三处最容易翻车。
- 目标路径必须可写，且父目录存在；
go build -o ./out/app要求./out目录已创建，否则静默失败 - Windows 下生成的可执行文件默认带
.exe后缀，即使你写了-o ./app，实际产出仍是app.exe；Linux/macOS 不加后缀就是纯二进制 - 跨平台编译时，
GOOS和GOARCH必须在命令前设好：GOOS=linux GOARCH=amd64 go build -o ./app-linux main.go，顺序错了就编成本地平台
VS Code 里点击运行按钮没反应，或提示 “no Go files in current directory”
VS Code 的 Go 插件（Go by Google）依赖 gopls 语言服务器工作，而 gopls 启动前提是项目有有效模块上下文。
立即学习“go语言免费学习笔记（深入）”；
- 首次打开项目时，如果没
go.mod，插件可能不激活；手动在终端执行go mod init example.com/myproj再刷新窗口 - 检查状态栏右下角是否有
Go标识和版本号；没有就点它，选 “Install All Tools”，重点确认gopls和dlv是否成功安装 - 如果项目在
GOPATH/src下但没启用 Modules（GO111MODULE=off），VS Code 可能退回到旧式 GOPATH 模式，导致路径解析混乱——直接go env -w GO111MODULE=on强制启用
go，还是 gopls 没加载模块，抑或 go build 的输出路径根本不可写。每层都得单独验证，跳步就白忙。 
