go version报错说明PATH未正确配置或终端未重启；GOROOT是Go安装目录（如/usr/local/go），GOPATH是用户代码与依赖根目录（如~/go），Go 1.16+后GOPATH仅影响go install输出位置，项目可任意路径初始化module。
go version 命令报错或不识别
说明你没把 go 二进制路径加进 PATH，或者安装后没重启终端。Windows 上常见是安装时勾选了“Add Go to PATH”，但实际没生效；Linux/macOS 则常因 shell 配置文件（.bashrc、.zshrc）没重载。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先确认
go是否真在磁盘上：Windows 查C:\Go\bin\go.exe，macOS/Linux 查/usr/local/go/bin/go - 手动临时测试：
/usr/local/go/bin/go version（Linux/macOS）或C:\Go\bin\go.exe version（Windows） - 若能执行，说明只是
PATH没配对：把对应目录加到PATH，然后source ~/.zshrc或重启终端 - 别用
which go或where go判断——它只查当前 shell 环境，不反映全局配置是否生效
GOROOT 和 GOPATH 容易混淆的两个路径
GOROOT 是 Go 自身的安装目录（比如 /usr/local/go），GOPATH 是你写代码、放依赖、编译产出的地方（比如 ~/go）。Go 1.16+ 默认启用模块（GO111MODULE=on），这时 GOPATH 只影响 go install 生成的可执行文件存放位置（即 $GOPATH/bin），不再强制要求项目必须放在 $GOPATH/src 下。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 不要把项目硬塞进
$GOPATH/src/github.com/xxx——现代 Go 项目直接在任意目录初始化go mod init example.com/myapp即可 -
GOROOT一般由安装程序自动设好，除非你手动解压 tar.gz，否则不用动；GOPATH推荐设成一个干净路径（如~/go），避免空格或中文路径 - 运行
go env看输出，重点关注GOROOT、GOPATH、GO111MODULE和GOPROXY四项
go get 失败或超时，尤其在国内
默认代理 proxy.golang.org 在国内访问不稳定，go get 或 go mod download 经常卡住或报 no required module provides package 类错误，本质是模块索引拉不下来。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 优先设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/,direct - 如果公司内网有私有代理，用
go env -w GOPROXY=http://your-proxy:8080，并确保NO_PROXY包含localhost和内部域名 - 别用
export GOPROXY=...临时设置——go env -w写入的是用户级配置，更可靠 - 遇到
invalid version: git ls-remote错误，大概率是代理没生效或模块仓库本身不可达，先curl -v https://goproxy.cn测试连通性
VS Code 中 go extension 提示 “Missing tools”
这是 VS Code 的 Go 插件发现缺少 gopls、dlv、goimports 等工具，不是 Go 本身没装好，而是插件依赖的 CLI 工具没装全。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 点提示里的 “Install All” 按钮——但经常失败，因为网络或权限问题
- 手动装最核心的一个：
go install golang.org/x/tools/gopls@latest，装完重启 VS Code - 如果提示
cannot find module providing package，说明模块代理没设好，先解决上一条的GOPROXY - Windows 用户注意：PowerShell 默认禁止执行脚本，遇到
execution policy报错，运行Set-ExecutionPolicy RemoteSigned -Scope CurrentUser即可
$GOCACHE）和代理设置一旦出问题，错误表现往往像环境没装好，其实只是网络或配置没对齐。调试时别急着重装 Go，先 go env 和 curl -v $GOPROXY 看两眼，省掉大半排查时间。 
