go version报command not found说明path未包含go二进制路径，核心是确认goroot指向解压根目录（如/usr/local/go）且path包含$goroot/bin；goroot为空或错误会导致fmt等标准库找不到，需验证$goroot/src/fmt存在且架构匹配。
go version 命令报 command not found
说明 Go 二进制没进 PATH，不是安装失败，而是环境变量没生效。重点查两件事：GOROOT 是否指向解压后的根目录（如 /usr/local/go），以及 PATH 是否包含 $GOROOT/bin（Linux/macOS）或 %GOROOT%\bin（Windows）。常见坑是改了 ~/.bashrc 却忘了 source ~/.bashrc，或者在 Windows 上改了用户变量却没重启终端。
go env 输出 GOROOT 为空或路径错误
GOROOT 被设错会导致标准库（比如 fmt）找不到。Go 官方二进制包自带标准库，必须和 GOROOT 严格对应。不要把 GOROOT 指向自己的项目目录或 GOPATH；它只该是安装目录（/usr/local/go 或 C:\Go）。如果手动解压过，确认 /usr/local/go/bin/go 确实存在且可执行——用 file /usr/local/go/bin/go 检查架构是否匹配当前系统（比如 x86_64 机器不能用 arm64 包）。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
go run main.go 报 cannot find package "fmt"
这不是代码问题，是 Go 运行时找不到标准库。90% 是 GOROOT 错了，剩下 10% 是文件损坏或权限问题。先运行 ls $GOROOT/src/fmt，看目录是否存在；再检查 $GOROOT/src 下有没有完整子目录结构。如果用的是自编译版或非官方镜像，可能缺了 src 目录——这种包不能直接用，得重下官方 .tar.gz 包。
go mod init 后 go build 仍报 missing package
模块初始化只是生成 go.mod，不自动拉依赖。关键动作是 go mod tidy：它读 import 语句、补全 go.mod、下载缺失包到 pkg/mod。如果 import 的是私有仓库（如 git.internal.company/lib），还得提前设 GOPRIVATE=git.internal.company，否则 Go 默认走公共代理，直接 404。另外注意：别在 $GOPATH/src 下初始化模块，GO111MODULE=on 时会静默失效。
go version 失败，你去重装又覆盖了旧 GOROOT，结果 go env 显示路径对但实际指向空目录。建议按顺序验证：go version → go env GOROOT → ls $GOROOT/src/fmt → go run main.go → go mod tidy，中间任一环节断掉，就停在那里修，别跳步。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
