根本原因是系统未将go二进制目录加入$path；macos/linux需在~/.zshrc或~/.bash_profile中添加export path=$path:/usr/local/go/bin并source，windows需手动添加到系统path环境变量。
Go 语言安装后 go version 报错：command not found
根本原因是系统没把 Go 的二进制目录加进 $PATH。macOS/Linux 下通常解压到 /usr/local/go，但 shell 不会自动识别；Windows 则要手动改系统环境变量。
- macOS/Linux：在
~/.zshrc或~/.bash_profile末尾加export PATH=$PATH:/usr/local/go/bin，然后运行source ~/.zshrc - Windows：右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”里找到
Path→编辑→新增一行：C:\Program Files\Go\bin（路径以你实际安装位置为准） - 验证是否生效：新开终端，执行
go version，看到类似go version go1.22.5 darwin/arm64才算成功
用 go install 安装命令行工具时提示 cannot find module providing package
这是 Go 1.16+ 默认关闭了 GOPATH 模式后的常见报错，本质是 Go 不知道该从哪找包——它现在默认只认模块（go.mod），而你直接敲 go install xxx@latest 时没指定模块上下文。
- 解决方法很简单：加上
-v和-u参数，并确保用完整包路径，比如go install golang.org/x/tools/gopls@latest - 如果提示
no required module provides package，大概率是你当前目录有go.mod且没包含该包依赖，此时退出项目目录再执行即可 - 注意：Go 1.21+ 要求必须带版本后缀（如
@latest或@v0.14.0），空着会失败
GO111MODULE 开还是关？什么时候必须设为 on
它控制 Go 是否强制启用模块模式。默认值在 Go 1.16+ 是 on，但如果你在老项目或某些 CI 环境里遇到依赖拉不下来、go get 行为异常，很可能是它被意外设成了 off。
- 本地开发建议始终设为
on：执行go env -w GO111MODULE=on - 只有当你明确维护一个纯 GOPATH 项目（无
go.mod，所有依赖都在$GOPATH/src），才考虑临时关掉，但这种情况现在极少 - 设为
auto看似折中，实则容易误判：只要当前目录下有go.mod就开，否则关——但很多脚本或 IDE 启动时 cwd 不确定，导致行为不一致
为什么 go run main.go 能跑，但 go build 出来的二进制一运行就 panic：failed to initialize module
这不是环境问题，而是代码里用了 embed、io/fs 或某些需要模块元信息的特性，而构建时没带上模块上下文。典型表现是程序启动时读不到内嵌文件，或 runtime/debug.ReadBuildInfo() 返回 nil。
- 确认构建命令是否在模块根目录（即有
go.mod的目录）下执行 - 不要用
go build ./... -o app这种模糊路径，改用go build -o app .（点号表示当前模块） - 如果必须跨目录构建，加
-mod=readonly参数避免意外修改go.mod，但别用-mod=vendor——除非你真有vendor/目录且已同步好
go.mod、或者 IDE 启动终端时没读取你的 shell 配置。动手前先 go env 看一眼实际值，比猜更省时间。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
