go version报错说明PATH未配置：先确认go二进制是否存在，再检查PATH是否包含其路径，Linux/macOS需source shell配置文件；GOPATH在Go 1.11+非必需但建议显式设置以支持go install；模块未初始化导致“no required module”错误，应运行go mod init；“exec format error”源于跨平台编译未指定GOOS/GOARCH。
go version 命令报错或不识别
说明：这不是 Go 没装好，而是 PATH 没配对。Windows 上常见是安装时勾选了“Add to PATH”但实际没生效；Linux/macOS 则常因 shell 配置文件（~/.bashrc、~/.zshrc 或 /etc/profile）没 reload。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先确认
go二进制是否存在：ls /usr/local/go/bin/go（Linux/macOS）或where go（Windows PowerShell） - 若存在但命令不可用，检查
echo $PATH是否包含/usr/local/go/bin（Linux/macOS）或%GOROOT%\bin（Windows） - 临时测试可用性：直接运行
/usr/local/go/bin/go version—— 成功则说明路径问题，不是安装问题 - Linux/macOS 配完记得
source ~/.zshrc（或对应 shell 文件）；Windows 修改环境变量后需重启终端或 CMD
GOPATH 还需要手动设置吗？
说明：Go 1.11+ 默认启用 go mod，项目不再强制依赖 GOPATH/src 目录结构。但 GOPATH 仍影响 go install 输出位置和 go get 下载的旧式包存放路径。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 新项目直接在任意目录
go mod init example.com/hello即可，无需提前建$GOPATH/src/... -
GOPATH仍建议显式设为$HOME/go（Linux/macOS）或%USERPROFILE%\go（Windows），否则go install会报错 “cannot install: no bin directory” - 验证方式：
go env GOPATH应返回明确路径；go env GOROOT应指向 Go 安装根目录（如/usr/local/go） - 注意：
GOROOT通常自动设置，除非你手动移动过 Go 安装目录，否则不要改它
go run hello.go 提示 “no required module provides package”
说明：这是 Go Modules 启用后的典型提示，不是环境没搭好，而是当前目录没初始化模块，Go 不知道该从哪找依赖或如何解析 import 路径。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 进入项目目录，运行
go mod init example.com/hello（模块名可任意，但建议用域名格式） - 执行后生成
go.mod文件，再试go run hello.go就能通过 - 如果已有
go.mod但报错，可能是模块名与 import 路径不匹配 —— 检查hello.go中的import是否引用了不存在的包，或go.mod里module行写错了 - 想临时绕过模块机制？加
-mod=mod参数：go run -mod=mod hello.go，但不推荐长期这么做
跨平台编译时提示 “exec format error”
说明：你在 Linux 上编译出的二进制，直接拷到 Windows 运行会失败，因为可执行文件格式不同（ELF vs PE）。这不是环境问题，是 Go 编译目标平台没指定。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 编译前设置目标 OS 和 ARCH：
GOOS=windows GOARCH=amd64 go build -o hello.exe hello.go - 常用组合：
GOOS=linux GOARCH=arm64（部署到树莓派/ARM 服务器），GOOS=darwin GOARCH=arm64（M1/M2 Mac） - 注意：交叉编译不需要目标平台安装 Go，但必须确保源码中没调用平台专属 syscall 或 cgo 代码
- 如果用了
cgo，交叉编译会失败 —— 此时要么关掉 cgo（CGO_ENABLED=0），要么在目标平台本地编译
GOPATH 没设，go install 就找不到 bin 目录；GOBIN 若被误设，又会覆盖 $GOPATH/bin 的行为。这些细节不报错、不提示，只在某条命令突然失效时才暴露出来。 
