运行 go version 仅验证 PATH 中 go 可执行文件存在，不确保环境完全可用；需进一步检查 GOROOT、GOBIN、GOPATH、GO111MODULE 配置，并通过 go mod init、go run - 等组合测试确认环境健康。
安装完 Go 后，go version 能输出版本号 ≠ 环境就完全可用——很多实际问题（比如 go mod init 报错、go run 找不到包、GOROOT 和 GOBIN 冲突）都在“能输出版本”之后才暴露。
运行 go version 只是第一关，不是通关凭证
它只验证了 PATH 里能找到 go 二进制，不检查：
– GOROOT 是否指向真实安装路径（尤其 Windows MSI 安装后常被设成默认值而非实际路径）
– GOBIN 是否为空（非空时可能干扰 go install 输出位置）
– GOPATH 是否被意外污染（Go 1.16+ 默认启用 module 模式，但某些旧脚本或 IDE 仍会读它）
– GO111MODULE 是否为 on（否则 go mod 命令可能静默失效）
建议立即执行：
go env GOROOT GOPATH GOBIN GO111MODULE
对照预期：
– GOROOT 必须是解压/安装目录（如 /usr/local/go 或 D:\Program Files\Go），不能是空或错误路径
– GOBIN 推荐留空（让 go install 默认写入 $GOPATH/bin）
– GO111MODULE 必须是 on（Go 1.16+ 默认值，若显示 auto，说明环境变量或 shell 配置覆盖了它）
go mod init 失败？大概率是当前目录权限或路径含空格/中文
新建一个干净目录（如 ~/tmp/go-test），运行：
go mod init example.com/test
失败常见原因：
– 目录名含中文或空格（如 我的项目、go test）→ 改用纯英文下划线命名
– 当前目录在系统受保护路径下（如 Windows 的 C:\Program Files）→ 换到用户主目录下试
– go.sum 文件残留且签名不匹配（少见，删掉重试即可）
– GO111MODULE=off 被硬编码 → 检查 go env 输出并临时设为 on：go env -w GO111MODULE=on
go run main.go 报 “cannot find package”？检查 package main 和文件名
这是新手最常卡住的点。最小可复现代码必须同时满足：
- 文件名是
main.go（不能叫hello.go或test.go） - 首行是
package main（不能是package test或漏写） - 有且仅有一个
func main()函数
示例正确结构：
package main
import "fmt"
func main() {
fmt.Println("ok")
}
如果仍报错：
– 确认当前终端没在 go.mod 之外的子目录里（go run 会尝试加载模块依赖）
– 临时关闭 module 模式测试：GO111MODULE=off go run main.go（仅用于排除干扰）
真正能证明环境健康的自测组合
别只跑一条命令。按顺序执行这四步，全部成功才算过关：
-
go version→ 输出类似go version go1.24.0 linux/amd64 -
go env GOROOT→ 路径存在且可读（ls $(go env GOROOT)/bin/go不报错） -
go mod init example.com/hello && go mod tidy→ 生成go.mod和go.sum，无网络或权限错误 -
echo 'package main; import "fmt"; func main(){fmt.Println("live")}' | go run -→ 直接管道输入并执行，输出live
最后一步最关键：它绕过了文件系统权限、编码、IDE 缓存等所有中间层，直击 Go 工具链核心。只要这行失败，说明底层 runtime 或 linker 有隐性损坏，重装 Go 是最快解法。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
