go version报错说明系统找不到go二进制文件，根本原因是path未正确配置：windows需确认安装时勾选“add go to path”或手动添加%goroot%\bin到系统环境变量，macos/linux需在~/.zshrc或~/.bash_profile中添加export path=$path:/usr/local/go/bin并source生效。
go version 命令报错或无输出
说明 go 二进制根本没被系统识别，不是“装得不对”，而是“压根找不到”。这不是代码问题，是路径配置失效。
- Windows 上检查是否勾选了安装器的「Add Go to PATH」；手动解压安装的，确认
%GOROOT%\bin（如C:\Go\bin）已加入系统环境变量PATH - macOS/Linux 检查 shell 配置文件（
~/.zshrc或~/.bash_profile）里有没有类似export PATH=$PATH:/usr/local/go/bin，改完必须source生效 - 运行
where go（Windows）或which go（macOS/Linux）看是否返回路径；若返回多个路径，说明有旧版本残留，优先清理$HOME/go/bin或/usr/local/bin/go
go run main.go 提示 cannot find package "fmt"
这表示 Go 编译器能启动，但找不到标准库——GOROOT 指向错误或 GOROOT/src 缺失。和网络、代理、模块无关，纯本地路径问题。
- 执行
go env GOROOT，确认输出是真实安装目录（如/usr/local/go），而不是空、$HOME/go或项目目录 - 进入该目录，检查是否存在
src/fmt子目录；若缺失，说明解压不完整或被误删，需重装 - Windows 用户特别注意：路径含中文、空格或符号（如
C:\Program Files\Go）极易触发此错，安装时务必选纯英文无空格路径（如C:\Go）
go mod init 后 go list -m 报错或静默无输出
模块系统启动失败，通常不是 Go 本身坏了，而是当前目录或环境状态干扰了模块判定逻辑。
- 确保不在
$GOPATH/src下执行go mod init，否则可能降级回 GOPATH 模式（尤其GO111MODULE=auto且目录匹配旧路径规则时） - 检查当前目录是否有残留的
go.mod或go.sum，它们可能来自其他项目，导致解析冲突 - 临时清掉
GO111MODULE干扰：go env -u GO111MODULE，再试go mod init example.com/test；成功后可设回go env -w GO111MODULE=on
go build 生成可执行文件但运行时报 permission denied
Linux/macOS 下常见，本质是文件权限未开放，和 Go 无关，但新手容易误判为环境故障。
-
go build默认生成的文件没有执行权限，必须手动加：chmod +x ./main（或你指定的输出名） - 不要用
go run成功就以为go build也一定行——前者绕过文件权限检查，后者严格依赖系统权限模型 - 如果
chmod后仍报错，检查是否在 NFS 或挂载的只读文件系统上构建，这类路径天生不支持设执行位
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
