能跑go version就算装好，但真正可用需过三关：PATH配对、GOPROXY设对、IDE读到环境变量；PATH未生效导致command not found，GOPROXY未设致go mod download卡顿或403，IDE未加载环境变量则gopls失效。
能跑 go version 就算装好了，但真正能写、能调试、不卡顿的环境，得过三关：PATH 配对、GO_PROXY 设对、IDE 读到环境变量。
go version 报 command not found 怎么办
这不是 Go 没装，是 shell 找不到 go 命令——根本原因是 PATH 没生效。
- Windows 用户：安装
.msi后必须关掉所有 CMD/PowerShell 窗口再重开，否则系统环境变量不会自动加载 - macOS/Linux 用户：别只改
~/.bashrc，zsh 默认读~/.zshrc；改完要执行source ~/.zshrc，不是只写完就完事 - 验证方式不是看安装目录有没有
go/bin/go，而是直接运行which go；输出为空就说明 PATH 没配对 -
GOROOT大多数情况不用手动设——官方安装包会自动指向正确位置；只有你手动解压.tar.gz到非标准路径（比如~/sdk/go1.25）才需要显式export GOROOT=~/sdk/go1.25
go mod download 卡住或报 403 怎么破
这是国内最常见问题，本质是没设 GO_PROXY，proxy.golang.org 直连基本不可用。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 执行这行命令一次性设好：
go env -w GOPROXY=https://goproxy.cn,direct -
direct必须放在末尾，否则公司私有模块（比如git.internal.company.com/mylib）无法直连，会走代理然后 404 - 验证是否生效：
go env GOPROXY输出应为https://goproxy.cn,direct；再试go mod download github.com/spf13/cobra，几秒内完成即成功 - VS Code 的
gopls会继承 shell 环境变量，但 GoLand 必须在 Settings → Go → GOROOT 页面点 “Reload” 或重启 IDE 才刷新代理配置
VS Code 提示 “Go command not found” 或跳转失效
不是插件坏了，是编辑器根本没拿到你 shell 里的环境变量，或者项目没进 Modules 模式。
立即学习“go语言免费学习笔记（深入）”；
- 先确认终端里
go version和go env GOPROXY都正常，再打开 VS Code —— 推荐从终端启动：code .，而不是双击图标 - 新建项目时别漏掉
go mod init myproject；没有go.mod文件，gopls会退化成纯文本分析，跳转、补全全失效 - 如果用了
replace指向本地路径，确保路径存在且可读；replace ./local => ../other/local这种相对路径一旦挪动文件夹就立刻报红 -
go clean -modcache比手动删$GOPATH/pkg/mod安全得多，后者容易删错目录导致gopls启动失败
最容易被忽略的是：GoLand 和 VS Code 对环境变量的加载时机完全不同，同一套配置在两个 IDE 里可能一个正常一个报错；别假设“设好了就一劳永逸”，每次换 IDE 或升级 Go 版本后，都得重新验证 go env 在编辑器内置终端里是否和外置终端一致。
