go version 报 command not found 是因 path 未包含 go 二进制路径；需根据 shell（zsh/bash）或系统（windows）正确配置 path，并新开终端验证；其他常见问题如 go get 失败、代理设置、goroot 错误等也需对应排查。
go version 报 command not found 怎么办
这是环境变量没配对的直接信号，不是安装失败，而是系统根本找不到 go 这个命令。
先确认 go 二进制是否真在预期位置：
- Linux/macOS：运行
ls -l /usr/local/go/bin/go（或$HOME/sdk/go/bin/go），看文件是否存在 - Windows：检查安装路径（默认是
C:\Go\bin），确认该目录下有go.exe
常见错因和操作建议：
- Zsh 用户（macOS Catalina+、多数 Linux）：编辑
~/.zshrc，末尾加export PATH="/usr/local/go/bin:$PATH"，然后source ~/.zshrc - Bash 用户：改
~/.bashrc或~/.bash_profile，同样追加 PATH，再source - Windows 用户：进「系统属性 → 高级 → 环境变量」，在「系统变量」或「用户变量」的
Path里新增一行C:\Go\bin（注意：不要带引号，也不要写成C:\Program Files\Go\bin） - 改完必须新开终端验证，旧终端不会自动 reload
go get 卡住或报 failed to load mod file
本质是当前目录没有 go.mod，而 Go 拒绝在非模块上下文里写依赖 —— 不是网络问题，是语义拒绝。
分场景处理：
- 想初始化新项目：先执行
go mod init example.com/myapp（模块名必须是合法路径，不能含大写字母、短横线或以数字开头） - 只想装工具（如
gopls）：用-d参数跳过构建，例如go install golang.org/x/tools/gopls@latest - 误在
$GOPATH/src下执行了go get：退出该目录，换到任意空目录再试；Go 1.16+ 已默认禁用 GOPATH 模式
国内用户额外注意：如果卡在 Fetching，大概率是 golang.org 域名被阻断。执行 go env -w GOPROXY=https://goproxy.cn,direct 即可解决。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
GOPROXY 和 GOSUMDB 设置不当导致依赖拉不下来
Go 1.13+ 默认启用模块代理，但国内直连 proxy.golang.org 几乎必然失败，且 GOSUMDB=off 是危险操作，仅限临时调试。
正确做法：
- 设代理：运行
go env -w GOPROXY=https://goproxy.cn,direct（direct不能省，否则私有模块无法拉取） - 校验开关：若公司内网用自签名证书的私有 proxy，需额外设
go env -w GOSUMDB=off，但上线前必须关掉 - 验证生效：执行
go env GOPROXY，输出应为https://goproxy.cn,direct
注意：GOPROXY 只影响 Go 自身模块下载，不影响 git 命令；若用 git 协议拉私有库，还需单独配 git config --global http.sslCAInfo。
GOROOT 设错引发 build 失败
GOROOT 应只指向 Go 安装根目录（如 /usr/local/go），它和 GOPATH 职责完全不同。手动设错 GOROOT 是高频翻车点。
排查步骤：
- 运行
go env GOROOT，看输出是否是你实际安装路径；若显示/home/user/go这类明显错误路径，说明被覆盖 - 全局搜索 shell 配置文件：
grep -r "GOROOT=" ~/.zshrc ~/.bashrc ~/.profile /etc/profile - 删掉所有类似
export GOROOT=$HOME/go的错误行 - 检查项目根目录下是否有
.env或go.env文件偷偷覆盖了环境变量
重装 Go 后，别急着手动设 GOROOT —— 正常安装（尤其是 .msi/.pkg）会自动设好，手动干预反而容易出错。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
