Go环境配置失败八成源于GOPATH、GO111MODULE或PATH配置错误；现代Go（1.13+）默认启用模块模式，GOPATH非必需，沿用旧教程易出错。
Go 环境装不起来，八成卡在 GOPATH、GO111MODULE 或 PATH 配置上；现代 Go（1.13+）其实已默认启用模块模式，GOPATH 不再是必须项，强行沿用旧教程配置反而容易出错。
go install 失败：command not found 或 version 报错
这是最常遇到的“环境没搭好”信号。根本原因不是 Go 没装，而是系统找不到 go 命令。
- Linux/macOS：检查是否执行了
source ~/.bashrc（或~/.zshrc），安装脚本里追加的export PATH=$PATH:/usr/local/go/bin必须生效 - Windows：安装 MSI 包后需重启终端；若用 ZIP 手动解压，务必把
go\bin路径加入系统PATH环境变量（不是用户变量） - 验证命令必须是
go version，不是golang version或go --version（后者在旧版本会失败）
go mod init 报错：cannot determine module path
新建项目时运行 go mod init 提示 “missing $GOPATH” 或 “no Go files in directory”，说明当前目录未被识别为模块根，或模块名非法。
- 确保你在空目录下执行，且该目录**不含中文、空格、特殊符号**（如
我的项目、go test都会失败） -
go mod init后必须跟一个合法模块路径，例如go mod init example.com/hello；用go mod init .会尝试自动推导，但失败率高，不建议 - 如果只是本地练习，模块名可任意（如
go mod init hello），无需对应真实域名；它只用于依赖管理，不影响编译
go run main.go 报错：package main is not a main package
看似简单，实则高频陷阱：Go 要求可执行程序必须同时满足两个条件——文件在 package main 中，且包含 func main() 函数。
立即学习“go语言免费学习笔记（深入）”；
- 检查文件开头是否有
package main（注意不能是package hello或漏写） - 检查
main()函数签名是否完整：func main()，不能带参数、不能有返回值 - 如果目录下存在多个
.go文件，确保**所有文件都属于package main**；混入package utils会导致构建失败 - Windows 下用记事本保存可能引入 BOM 头，导致解析失败；换 VS Code 或 LiteIDE 保存为 UTF-8 无 BOM 格式
真正麻烦的不是安装步骤，而是不同教程混用新旧范式：有人还在教 GOPATH/src 目录结构，而你现在用 go mod 根本不需要它；有人强调必须设 GOPATH，其实 Go 1.16+ 已将其降级为缓存目录，默认值足够用。盯住 go version 和 go env GOPATH 的输出，比照着删掉多余配置，比照着删掉多余配置，往往比重装更有效。
