go version报command not found是PATH未生效或安装路径错误；国内go mod tidy超时需设GOPROXY=https://goproxy.cn,direct；编辑器提示包未找到需手动安装gopls并确认PATH和GOPATH配置。
go version 命令报 command not found
说明系统根本没识别到 go 命令，不是 Go 没装好，而是 PATH 没生效或安装路径不对。
- Windows 上用 .msi 安装后，必须关闭所有 CMD/PowerShell 窗口再重开，否则注册表写入的环境变量不加载
- macOS/Linux 手动解压安装时，
GOROOT要指向解压后的根目录（如/usr/local/go），且需把$GOROOT/bin加进PATH - 执行
echo $PATH确认是否含go的 bin 目录；若没有，检查.zshrc或.bashrc是否漏写export PATH=$GOROOT/bin:$PATH - 别把
GOROOT和GOPATH设成同一路径——GOROOT是 Go 安装目录，GOPATH是你放代码和工具的地方，混用会导致go get失败
go mod tidy 报 failed to download golang.org/x/... timeout
这是国内最典型的网络问题，Go 默认代理 proxy.golang.org 不可达，不是你网络差，是它被墙了。
- 立刻设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct - 同时启用模块模式：
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但旧项目或某些 shell 环境可能仍为 auto/off） - 如果公司内网用私有仓库，加
go env -w GOPRIVATE=git.internal.company.com，避免代理劫持内部域名 - 设完后运行
go env | grep GOPROXY确认生效；再试go mod tidy，90% 超时问题当场消失
编辑器提示 “package not found” 或 “gopls not found”
VS Code、GoLand 这类 IDE 依赖 gopls 提供补全和跳转，但它不是随 Go 一起装的，得手动装，且路径必须对。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先运行
go install golang.org/x/tools/gopls@latest—— 注意不是go get，新版必须用go install - 确认
$GOPATH/bin在PATH中（which gopls应返回路径） - VS Code 中检查设置：搜索
go.gopath，值应为你的GOPATH；go.goroot应为GOROOT路径，不能留空 - 重启编辑器或按
Ctrl+Shift+P→ “Developer: Reload Window”，LSP 才会重新探测
go run main.go 报 undefined variable 或 cannot find package
这类错误看着像语法问题，实际八成是模块或路径配置错位，尤其新手爱把项目建在 $GOPATH/src 下还开 Modules。
立即学习“go语言免费学习笔记（深入）”；
- 删掉项目里的
go.mod，cd 进项目根目录，重新跑go mod init myproject（模块名建议用域名格式，如example.com/myapp） - 绝对不要把新项目放在
$GOPATH/src里——Modules 模式下，Go 会忽略该路径下的go.mod，强行降级回 GOPATH 模式 - 检查
import路径是否拼错，比如github.com/gin-gonic/gin少个-就报cannot find package - 变量报
undefined时，先看是否拼写大小写不一致（Go 区分大小写）、是否在作用域外引用（比如if块里声明的变量，在块外用）、是否漏写import（如用math.Pi却没import "math"）
GO111MODULE=off 时你配了 GOPROXY 也白搭；又比如 gopls 装在 $HOME/go/bin，但编辑器读的是另一个 GOPATH。动手前先跑一遍 go env，盯着输出里的 GOPATH、GOROOT、GO111MODULE、GOPROXY 四项，比盲试十次更省时间。 
