go version报错说明path未生效，非安装失败；windows需重启终端，linux/macos须手动添加/usr/local/go/bin并source配置文件；go mod init失败多因go111module=off或路径不合规，应设为on并用合法模块名初始化。
go version 命令报错或找不到命令
说明 Go 二进制文件没进系统 PATH，不是“没装好”，而是路径没生效。Windows 安装 .msi 包时默认会写入 PATH，但需重启终端或新建 CMD/PowerShell 才能读到；Linux/macOS 解压后必须手动加 /usr/local/go/bin 到 PATH，且要 source 配置文件（如 ~/.zshrc）。
- 检查是否真在 PATH 里：
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认含go的bin目录 - 别用旧终端窗口验证——关掉重开，或新开一个终端再试
go version - Mac M1/M2 用户若装了
darwin-arm64包却仍报错，可能是终端用了 Rosetta 模式，换原生 Terminal 再试
go mod init 初始化失败：no module found
常见于项目目录下没有 go.mod 文件，但更隐蔽的问题是当前路径不在 GOPATH/src 下且未启用 Modules —— 其实从 Go 1.16 起已默认开启，但某些老旧 shell 或 IDE 可能缓存了 GO111MODULE=off 环境变量。
- 运行
go env GO111MODULE，输出应为on；如果不是，执行go env -w GO111MODULE=on -
go mod init必须在空目录或已有 Go 文件的目录下运行，不能在~/go根目录直接 init（那不是项目目录） - 模块名不要用中文、空格或下划线开头，推荐形如
github.com/yourname/projectname，否则后续go get可能出错
VS Code 中 Go 插件提示 “Failed to install tools”
本质是插件试图自动下载 gopls、dlv 等工具时被墙或超时，不是插件本身坏了。
- 先手动设置代理：
go env -w GOPROXY=https://goproxy.cn,direct（国内推荐）或https://proxy.golang.org（官方） - 在 VS Code 设置中搜
go.toolsEnvVars，加一条："GOPROXY": "https://goproxy.cn" - 不要点插件弹窗里的 “Install All”，改用终端进项目目录后手动运行：
go install golang.org/x/tools/gopls@latest - 如果提示
cannot find package "golang.org/x/tools/gopls"，说明代理没生效，检查go env GOPROXY输出
GoLand 提示 “GOROOT is not configured”
GoLand 没自动识别 SDK 路径，尤其在非默认路径安装（比如自定义解压到 /opt/go）或 macOS 上通过 Homebrew 安装时容易发生。
- 打开
File → Settings → Go → GOROOT，点击+，手动指向 Go 安装根目录（不是bin子目录）：Windows 是C:\Go，macOS 是/usr/local/go或/opt/homebrew/opt/go/libexec - 别选错版本——如果同时装了多个 Go 版本，确保选的是你
go version输出的那个 - 配置完后点
Apply，再重启 GoLand，否则新设置不加载 - 如果项目里有
go.work文件，GoLand 会优先用它指定的 Go 版本，此时 GOROOT 设置可能被忽略
go run main.go 之前，最常卡在环境变量和代理这两层。很多人以为装完就完事，其实 PATH 和 GOPROXY 才是真正决定能不能动起来的开关。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
