Go环境默认启用Go Modules，无需GOPATH；安装后验证go version失败主因是PATH未正确配置，VS Code需重启窗口刷新环境，go run报错多因文件名、包名或代理设置不当。
Go 环境现在默认启用 Go Modules，GOPATH 不再是必需项；直接装好 SDK 就能写 hello world，不用手动建 src/pkg/bin 目录树。
go version 验证失败：PATH 没配对
常见现象是终端输入 go version 报错 command not found 或 'go' is not recognized。
- Windows 用户检查安装后是否真把
C:\Go\bin（或C:\Program Files\Go\bin）加进了系统 PATH，而不仅是用户 PATH —— CMD 默认读系统级变量 - macOS/Linux 用户若用
tar.gz手动安装，必须执行export PATH=$PATH:/usr/local/go/bin并source ~/.bashrc（或~/.zshrc），仅 echo $PATH 看得见不等于生效 - VS Code 终端可能缓存旧环境，重启窗口或执行
Command+Shift+P → Developer: Reload Window
go run main.go 报错 “no Go files in current directory”
这不是语法错，是项目结构或文件命名问题。
- 确保当前目录下有且仅有一个
.go文件，且文件名是main.go（不是helloworld.go或hello_world.go） - 文件开头必须是
package main，不能是package helloworld—— 否则go run无法识别入口 - 如果目录里已有
go.mod，但模块路径写错了（比如module example.com/hello），go run可能拒绝执行；临时解决：删掉go.mod再试
go mod init 初始化后 go.sum 为空或依赖拉不下来
本质是代理没设好，国内访问 proxy.golang.org 基本不可用。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/ - 若公司内网需私有仓库，追加
go env -w GOPRIVATE=git.example.com - 避免设成
https://goproxy.io—— 该服务已于 2023 年停止维护，会静默失败 -
go mod download成功后go.sum才会生成；空文件不是 bug，是还没触发依赖解析
VS Code 运行按钮灰色 / “Run Without Debugging” 报错 “Exec format error”
多见于 macOS M1/M2 或 Linux ARM 机器上，跟二进制架构错配有关。
- 确认 Go SDK 是对应 CPU 架构的版本：M 系列芯片必须用
darwin/arm64版，别误装darwin/amd64 - VS Code 插件
Go（由 golang.org/x/tools 提供）需匹配 Go 版本；Go 1.22+ 要求插件 >= v0.39.0 - 不要手动改
GOROOT指向旧版 Go 目录，VS Code 可能读错编译器路径；用go env GOROOT核对实际值
真正容易被忽略的是 go.mod 里的模块路径 —— 它不光影响 import，还决定 go run 是否接受当前目录为合法模块根。哪怕只写个 hello world，只要执行过 go mod init，就得保证路径合法，否则工具链会退回到 GOPATH 模式并报各种奇怪错误。
