答案：运行“go version”报“command not found”说明系统未识别go命令，核心原因是path未包含$goroot/bin或go未正确安装；需确认解压路径、补全path、执行source重载配置，并验证goroot指向有效安装目录。
运行 go version 报错但提示“command not found”
这说明系统根本找不到 go 二进制，不是版本问题，而是安装或环境变量彻底缺失。常见原因有：
• 安装包没解压或没放到 /usr/local/go 这类标准路径
• PATH 没包含 $GOROOT/bin（比如只加了 /usr/local/go，漏了 /bin）
• shell 配置文件（如 ~/.zshrc 或 /etc/profile）改了但没执行 source
• 终端新开后未重载配置（尤其 VS Code 内置终端、tmux session 常见）
go env 输出中 GOROOT 为空或指向错误路径
GOROOT 是 Go 运行时根目录，它不该由用户手动设错——除非你手动解压到非标路径又硬编码了错误值。正确做法是：
• 如果用 apt install golang 安装，GOROOT 通常自动设为 /usr/lib/go 或类似路径，不要覆盖
• 手动解压时，确保 tar -C /usr/local -xzf go*.tar.gz 后 /usr/local/go 存在且可读
• 若 go env GOROOT 返回空，说明 go 命令本身已失效，优先解决上一条问题
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
执行 go mod download 卡住或报 proxy.golang.org: no such host
这不是环境没装好，而是网络代理没配。Go 1.13+ 默认走 https://proxy.golang.org，国内直连基本失败。必须显式设置：
• 运行 go env -w GOPROXY=https://goproxy.cn,direct（推荐 goproxy.cn）
• 或 go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
• 注意末尾的 ,direct：允许私有模块绕过代理
• 不要设成 https://goproxy.io（该域名已停服）
• 验证：运行 go env GOPROXY 看输出是否生效
运行 go build 提示 cannot find package "fmt" 等标准库缺失
这是极少见但致命的问题，表明 GOROOT 下的 src/ 和 pkg/ 目录损坏或权限不足：
• 检查 $GOROOT/src/fmt 是否存在且可读（ls -l $GOROOT/src/fmt）
• 若用 apt 安装，尝试 sudo apt reinstall golang
• 若手动解压，确认 tar 包完整、解压过程无中断（校验 sha256 更稳妥）
• 切勿把 GOROOT 指向空目录或项目根目录——它必须是 Go 官方发布的完整安装树
~/.bashrc 里写的 export 在 zsh 终端里完全不生效；还有容器或 CI 环境中，go 命令可能存在于镜像里，但 GOPROXY 没继承，导致构建卡在依赖下载阶段。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
