go version 输出不可信，需通过 which go 和 go env GOROOT 交叉验证实际路径与环境变量是否一致，同时确认芯片架构匹配、杀毒软件未拦截、GOPROXY 已配置。
go version 输出是否可信？先看实际调用路径
看到 go version 有输出，不等于你用的是刚装的版本。常见问题是 PATH 中旧版 Go 的 bin 目录排在前面，比如 Homebrew 装的 /opt/homebrew/bin/go 覆盖了新装的 /usr/local/go/bin/go。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 运行
which go确认终端真正调用的是哪个二进制文件 - 执行
echo $PATH，检查新版路径（如/usr/local/go/bin）是否在旧路径之前 - 若用 zsh（macOS 默认），编辑
~/.zshrc，把export PATH="/usr/local/go/bin:$PATH"放在最前面，再source ~/.zshrc - Windows 用户用
where go，确认是C:\Go\bin\go.exe而非残留的旧路径
GOROOT 和 GOPATH 必须匹配真实路径
go env GOROOT 必须指向 Go 安装根目录（如 /usr/local/go 或 C:\Go），不能是子目录或空值；go env GOPATH 可以为空，但实际值需能查到——它决定 go install 生成的命令是否能在终端直接运行。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env GOROOT，输出为空或$HOME/sdk/go1.26.0这类路径时，要和which go结果交叉验证：如果which go是/usr/local/go/bin/go，但GOROOT是别的，说明环境变量被手动覆盖过 - 运行
go env GOPATH，若为空，再试go env -w GOPATH=$HOME/go显式设置（尤其 Windows 用户易因空格路径失败） - 确保
$GOPATH/bin已加入PATH：运行echo $PATH | grep "go.*bin"（macOS/Linux）或echo %PATH%手动搜（Windows）
go run main.go 卡住或报 cannot find package "fmt" 怎么办
这通常不是代码写错，而是 GOROOT 指向错误或标准库缺失。例如安装包解压到 C:\Program Files\Go（含空格），Go 会静默失败；又或者 macOS 上 M2 芯片误装了 amd64 包，导致 fmt 编译链接异常。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 新建干净目录（不要嵌套在已有
go.mod的父目录下），写最简main.go：package main import "fmt" func main() { fmt.Println("OK") } - 运行
go run main.go；若卡住几秒后无输出，可能是杀毒软件拦截临时二进制（Windows 常见） - 若报
cannot find package "fmt"，立刻检查GOROOT/src/fmt是否存在、是否可读；不存在则重装，别用解压工具跳过隐藏文件 - macOS M 系列芯片必须用
arm64包，uname -m输出arm64却装了amd64包，go run会静默失败
go mod init 和 go list -m 验证模块机制是否真启用
GO111MODULE=on 是硬性要求。设为 auto 或 off 时，go mod init 可能静默跳过，后续依赖拉不下来；而 go list -m 能暴露模块是否识别成功——它不依赖网络，只读本地 go.mod 和缓存。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 在测试目录运行
go mod init testenv，确认生成go.mod文件且第一行是module testenv - 立即运行
go list -m，应输出testenv；若报no modules found，说明模块未激活，检查go env GO111MODULE是否为on - 国内用户必须配代理：运行
go env -w GOPROXY=https://goproxy.cn,direct，否则go get golang.org/x/net/html极大概率超时 - 避免用
go get测试网络，改用go mod download golang.org/x/net@latest——它不触发构建，更快暴露代理问题
GOROOT 和 which go 不一致、芯片架构与安装包错配、以及杀毒软件对临时二进制的拦截——这些不会报明显错误，但会让 go run 表现异常。 
