go环境真正可用需同时验证三件事：go version输出版本号；go env goroot指向实际安装路径且含bin/go；go env gopath有值（推荐$home/go并确保目录存在），缺一不可。
go 命令能正常运行，不代表 Go 环境就 ready 了——很多初学者卡在 go mod init 报错、go run 找不到包、或依赖拉不下来，根本原因不是安装失败，而是环境变量和模块模式没对齐。
怎么验证 go 安装是否真正可用
只跑 go version 不够。必须同时确认三件事：
-
go version输出版本号（如go version go1.22.5 darwin/arm64） -
go env GOROOT指向实际安装路径（比如/usr/local/go），且该路径下存在bin/go -
go env GOPATH有值（即使你用 Go Modules，某些工具仍会读它），推荐设为$HOME/go并确保目录存在
如果 GOROOT 是空的，说明系统 PATH 没配对；如果 GOPATH 是空且你没手动设过，go 会 fallback 到 $HOME/go，但部分 IDE（如旧版 GoLand）可能不识别这个隐式路径。
go mod 初始化失败的常见原因
执行 go mod init example.com/hello 报错 go: modules disabled by GO111MODULE=off 或 unknown revision，基本是以下情况之一：
-
GO111MODULE环境变量被显式设为off—— 直接删掉这个变量或设为on - 当前目录在
$GOPATH/src下，而 Go 默认在该路径下禁用 modules（历史兼容行为）—— 换个目录，比如~/projects/hello - 公司内网或本地代理没配好，
go get走不通 —— 临时加export GOPROXY=https://proxy.golang.org,direct测试，再切回私有代理
注意：go mod init 不联网，但后续 go build 或 go run 第一次拉依赖时才会触发 proxy 请求。
Windows 上 PATH 配错最典型的两个坑
Windows 用户最容易栽在这两处：
- 安装时选了自定义路径（比如
C:\Program Files\Go），但环境变量里写的是C:\Go\bin——go命令根本找不到 - 用户变量和系统变量里都写了
PATH，但其中一条漏了\bin后缀（例如只写了C:\Go）——go可执行文件不在路径中
验证方法：打开新命令行窗口，运行 where go（Windows）或 which go（macOS/Linux）。输出必须是 xxx\go\bin\go.exe 这类带 \bin\ 的完整路径。
VS Code 里 go 插件报 “Command ‘go.tools.install’ failed” 怎么办
这不是插件坏了，而是它试图自动安装 gopls、dlv 等工具时权限或路径不对：
- 先手动运行
go install golang.org/x/tools/gopls@latest，看是否报错 - 如果提示
cannot find module providing package，说明GOBIN没设或不可写 —— 执行go env -w GOBIN=$HOME/go/bin（macOS/Linux）或go env -w GOBIN=%USERPROFILE%\go\bin（Windows） - 确保
$HOME/go/bin（或对应路径）已加入PATH，否则 VS Code 启动的终端看不到这些工具
别跳过 GOBIN 设置 —— 它决定了所有 go install 工具的落点，而 VS Code 的 Go 插件默认依赖这个位置。
GOROOT、GOPATH、GOBIN、GO111MODULE 这四个环境变量之间微妙的优先级和历史兼容逻辑。它们不报错，但会让 go mod 行为反直觉，让 IDE 找不到工具，让依赖永远拉不下来。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
