Go环境配置失败主因是路径混杂、代理未设及环境变量未继承；需统一which go与go env GOROOT路径，执行go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct，并从终端启动VS Code以确保环境变量生效。
Go 环境能跑 go run 不等于环境搭对了——真正卡住人的，是 go install 找不到命令、gopls 在 VS Code 里反复报错、或 go mod tidy 死在代理超时上。
go version 和 which go 不一致？先清掉残留 GOROOT
很多 macOS/Linux 用户用 Homebrew 装过旧版 Go（比如 go1.16），后来又手动解压新版到 /usr/local/go，结果 go version 显示新版本，which go 却指向 ~/homebrew/bin/go。这种路径混杂会导致 go env GOROOT 输出错误路径，进而让 go install 编译的二进制找不到 $GOPATH/bin。
- 运行
which go和go env GOROOT，两者输出路径必须完全一致 - 若不一致，删掉 Homebrew 安装的 Go：
brew uninstall go（macOS）或sudo apt remove golang-go（Ubuntu） - Windows 用户重点查注册表：运行
reg query "HKLM\SOFTWARE\GoLang" /s，删掉残留键值 - 重装推荐直接用官方
.tar.gz或.msi，不要依赖包管理器自动 PATH 注入
GO111MODULE=on 是默认值，但 GOPROXY 必须手动设
Go 1.16+ 默认启用模块模式，GO111MODULE 已无需设置。但国内用户不配 GOPROXY，go mod download 会卡在 proxy.golang.org，且不会 fallback 到 direct——它会直接失败，而不是跳过。
- 设代理只用一条命令：
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct - 别用
export GOPROXY=...写 shell 配置，go env -w写入的是 Go 自己的配置，优先级更高 - 验证是否生效：
go env GOPROXY应输出带,direct的字符串 - 如果项目里已有
go.mod但依赖拉不下来，先rm go.sum && go mod tidy，避免缓存干扰
go install . 为什么提示 “command not found”？检查 $GOPATH/bin 是否在 PATH
go install . 把当前模块编译成可执行文件，放进 $GOPATH/bin，但它不会自动加到系统 PATH。很多人以为“装了 Go 就能全局调用”，其实是漏了这一步。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env GOPATH查出实际路径（默认是$HOME/go） - 确认
$GOPATH/bin（如$HOME/go/bin）已加入 shell 的PATH，不是$GOPATH本身 - macOS/Linux：检查
~/.zshrc或~/.bashrc中是否有export PATH="$PATH:$GOPATH/bin" - Windows：在系统环境变量中确认
%GOPATH%\bin出现在 PATH 列表里，且不是写成%GOPATH%\bin\（末尾反斜杠会导致失效）
VS Code 里 gopls 总是崩溃？别急着重装插件
VS Code 的 Go 插件依赖 gopls 提供语言服务，但它启动失败往往不是插件问题，而是 GOPATH 或 GOPROXY 没被正确继承——终端里能跑的命令，在 GUI 应用里可能读不到 shell 配置。
- macOS：VS Code 从 Dock 启动时，不会加载
~/.zshrc；改用终端启动：code --new-window - Windows：PowerShell 用户需运行
refreshenv（如用 Scoop）或重启终端再开 VS Code - 检查
gopls是否真在$GOPATH/bin：运行ls $GOPATH/bin/gopls（macOS/Linux）或dir %GOPATH%\bin\gopls.exe（Windows） - VS Code 设置里搜
go.gopath，留空即可——让它读go env GOPATH，别硬编码路径
真正麻烦的从来不是“怎么装”，而是不同来源的 Go 二进制、多个 GOROOT、shell 和 GUI 环境变量不一致这三者叠加。每一步都验证输出，比盲目重装更省时间。
