go环境配置失败主因是path未正确包含go/bin目录；需手动添加/usr/local/go/bin（macos/linux）或c:goin（windows）并source或重启终端，再验证go version。
Go 环境装不上、go version 报错、go run 找不到命令——这些问题基本都出在环境变量没配对，而不是 Go 没装好。只要路径加对、变量设准，10 分钟内就能跑通第一个 main.go。
go version 命令无效？检查 PATH 是否包含 go/bin
这是 Windows/macOS/Linux 用户最常卡住的第一步。安装程序未必自动把 /usr/local/go/bin（macOS/Linux）或 C:Program FilesGoin（Windows）加进系统 PATH。
- macOS/Linux：运行
echo $PATH，确认输出里有/usr/local/go/bin；没有就补上：echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.zshrc && source ~/.zshrc - Windows：打开「系统属性 → 高级 → 环境变量」，在「系统变量」里找到
Path，新增一行：C:Program FilesGoin（注意别漏掉in） - 验证方式统一：新开一个终端（不是当前已打开的），再输
go version—— 重用旧终端会缓存旧 PATH
go mod init 失败或依赖拉不下来？必须开 GO111MODULE 并换国内代理
Go 1.16+ 默认启用模块（module）管理，但部分旧教程或误操作会关掉它，导致 go mod init 不生成 go.mod，或 go get 卡在 proxy.golang.org。
- 强制开启模块：运行
go env -w GO111MODULE=on - 换国内代理（关键）：运行
go env -w GOPROXY=https://goproxy.cn,direct（goproxy.cn是目前最稳的国内镜像） - 顺手检查：运行
go env GOPROXY，输出应为https://goproxy.cn,direct；若还是https://proxy.golang.org,direct，说明上一步没生效 - 注意：
direct保留很重要，它表示私有仓库走直连，否则公司内网模块会失败
GOPATH 还需要手动设吗？现代项目基本不用了
Go 1.11 引入 module 后，GOPATH 已退居二线。你现在写新项目，完全不需要把它当工作目录来用。
- 除非你维护老项目（Go 1.10 及以前）、或非要往
$GOPATH/src下放代码，否则别碰GOPATH -
go mod init myapp创建的项目，可以放在任意路径，比如~/projects/myapp，和GOPATH无关 - 如果仍想设（比如某些 IDE 插件依赖），只设
GOPATH就够了，GOBIN和GOPATH绑定即可，无需单独配置 - 运行
go env GOPATH查看当前值，默认是$HOME/go（macOS/Linux）或C:Users\go（Windows），保持默认最省心
VS Code 跑不起来 go run？确认 Go 扩展和 PATH 同步
VS Code 的 Go 扩展（由 golang.org/x/tools 提供）会读取终端的 PATH，但它启动时可能用的是旧 shell 环境，导致找不到 go 命令。
- 不要直接点「运行」按钮，先在 VS Code 内置终端（
Ctrl+`）里手动执行go run main.go，成功了再排查扩展问题 - 如果终端里能跑，但点击 ▶️ 报
command 'go.run' not found，说明 Go 扩展没装或禁用了：打开扩展面板搜 “Go”，确保 “Go by Go Team” 已启用 - Mac 用户特别注意：用 Launchpad 打开的 VS Code，PATH 可能不继承 shell 配置。改用终端命令启动：
code .，这样 PATH 才一致
最容易被忽略的一点：所有环境变量修改后，必须新开终端或重新加载 shell 配置（如 source ~/.zshrc），VS Code 也要重启内置终端甚至整个编辑器——PATH 不是改了就立刻全局生效的，它是一次性快照。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
