go环境可用的核心标准是：能执行go version、能go mod init成功生成go.mod、能go run最简main.go；其余配置均为可选增强项。
Go 1.22+ 安装后 go version 报错：command not found
不是没装好，是 $PATH 没生效。macOS 和 Linux 默认不把 /usr/local/go/bin 加进 shell 启动文件；Windows 则常漏掉系统环境变量更新。
- macOS（zsh）：执行
echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.zshrc && source ~/.zshrc - Linux（bash）：改
~/.bashrc，加同样 export 行，再source ~/.bashrc - Windows：手动打开「系统属性 → 高级 → 环境变量」，在「系统变量」里找到
Path，新增C:\Go\bin（注意路径是否匹配你实际安装位置）
验证：新开终端运行 go version，应输出类似 go version go1.22.4 darwin/arm64。
用 go mod init 初始化模块却提示 go: cannot find main module
这不是权限或网络问题，而是当前目录不在 GOPATH 且未初始化模块——但 Go 1.16+ 已默认启用 module 模式，go mod init 必须显式执行，且不能在空目录或非项目根目录下乱跑。
- 确保你在项目根目录（比如
~/myapp），且该目录下有main.go或计划放入口文件 - 运行
go mod init myapp（模块名建议用域名或有意义的短名，避免纯数字或保留字） - 如果已有
go.mod但报错，先检查是否误删了它，或是否在子目录里执行了命令
成功后会生成 go.mod 文件，首行是 module myapp，第二行是 go 1.22（版本自动匹配当前 Go 版本）。
go run main.go 编译失败：missing required flag -ldflags 或 import 错误
大概率是 main.go 文件本身不合规，而非环境问题。Go 对入口文件有硬性要求：必须在 package main 下，且含 func main() 函数。
- 确认第一行是
package main（不能是package main_test或其他） - 确认有且仅有一个
func main() { ... }，哪怕只写fmt.Println("ok") - 如果用了
fmt，必须显式导入：import "fmt"；Go 不允许隐式依赖 - 别把文件命名为
main_test.go——测试文件不会被go run执行
最小可用示例：
package main
import "fmt"
func main() {
fmt.Println("Hello, Go")
}
Windows 上 go run 卡住 5 秒才输出，或 macOS 显示 cannot load runtime/cgo
这是 CGO 默认开启导致的延迟或构建失败，尤其在无 C 工具链的干净环境（如新装 WSL、Docker 容器、部分 macOS M 系列机器）中常见。不需要 C 交互时，关掉它最省事。
- 临时关闭：运行
CGO_ENABLED=0 go run main.go（Linux/macOS）或set CGO_ENABLED=0 && go run main.go（Windows cmd） - 永久关闭（推荐开发机）：在 shell 配置中加
export CGO_ENABLED=0，再source一次 - 注意：关闭后无法使用
cgo包（如数据库驱动里的sqlite3原生绑定），纯 Go 实现的驱动（如lib/pq、go-sqlite3的纯 Go 模式）仍可用
真正卡住或报错时，先试 CGO_ENABLED=0，90% 能绕过初始化阶段的工具链探测逻辑。
go version、能 go mod init 成功生成 go.mod、能 go run 一个最简 main.go。其余都是可选增强项，别被文档里一堆配置项带偏节奏。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
