“command not found: go”主因是PATH未正确配置，需将Go的bin目录（如/usr/local/go/bin或C:\Go\bin）加入PATH并source生效；“cannot find package”多因GOROOT与GOPATH混淆；go mod download卡住通常因GOPROXY未启用或配置错误。
“command not found: go”不是没装，是 PATH 没加对；cannot find package 多半是 GOROOT 和 GOPATH 混了；go mod download 卡住不是网络差，是 GOPROXY 没开。
go 命令找不到：PATH 配置错位最常见
你执行 ls /usr/local/go/bin/go（macOS/Linux）或 dir C:\Go\bin\go.exe（Windows）能看见二进制，但终端敲 go version 报 command not found: go，90% 是 PATH 问题。
-
PATH必须包含/usr/local/go/bin（不能只写/usr/local/go），Windows 是%GOROOT%\bin - macOS 默认用 zsh，改
~/.zshrc；如果换过 shell 或用旧系统，可能是~/.bash_profile - 别写
export PATH=/usr/local/go/bin——这会覆盖原有PATH，导致ls、git全挂 - 正确写法：
export PATH=$PATH:/usr/local/go/bin（pkg 安装）或export PATH=$PATH:/usr/local/opt/go/libexec/bin（Homebrew 安装） - 改完必须运行
source ~/.zshrc，新开终端不生效；验证用echo $PATH | grep -o "/usr/local/go/bin"
cannot find package：GOROOT 和 GOPATH 指向冲突
错误信息里出现 from $GOROOT 和 from $GOPATH 两行路径，说明 Go 在两个地方都找包但都失败了——根本原因是 GOROOT 被设成工作区路径（比如 /var/lib/jenkins/workspace），或两者被设成同一目录。
-
GOROOT是 Go 自己的家（安装目录），比如/usr/local/go；GOPATH是你写代码的家（工作区），比如$HOME/go；它们绝不能一样 - 手动设
GOROOT是反模式，pkg/Homebrew 安装后它通常自动正确；运行go env GOROOT看输出是否合理 - 不要在
$GOPATH目录内初始化模块：go mod init应该在项目根目录（$HOME/project），而非$GOPATH/src/xxx - Jenkins 等 CI 场景下，别在构建脚本里硬编码
GOROOT，优先用 Go 插件自动管理 - 权限问题也常伪装成此错误：检查
~/go归属，若 owner 是root，运行sudo chown -R $(whoami) ~/go
go mod download 卡住或超时：GOPROXY 没启用或配错
报错含 dial tcp: i/o timeout、proxy.golang.org refused 或卡在 fetching dependencies，基本可断定是代理没走，不是本地网络差。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- Go 1.16+ 默认启用模块，但默认代理仍是境外的
https://proxy.golang.org；国内必须显式配置 - 启用模块：
go env -w GO111MODULE=on（老项目也建议开） - 设国内代理（推荐七牛或清华）：
go env -w GOPROXY=https://goproxy.cn,direct - 私有仓库必须排除：
go env -w GOPRIVATE=git.company.com/internal，否则会因认证失败中断 - PowerShell 用户注意：
go env -w在某些环境下只写入当前会话；验证需新开窗口，或手动写入$PROFILE
go install 生成的二进制无法运行：GOBIN 和 PATH 不匹配
go install golang.org/x/tools/gopls@latest 成功但运行 gopls 报 command not found，或者提示 missing DLL（Windows），说明生成的可执行文件没进 PATH。
-
go install默认把二进制放进$GOPATH/bin，不是$GOROOT/bin - 务必把
$GOPATH/bin加进PATH，例如：export PATH=$PATH:$GOPATH/bin - 别把
$GOPATH和$GOROOT设成同一目录，否则go install可能覆盖go自身工具（如go、gofmt） - Windows 上注意
GOBIN变量：如果设了GOBIN，go install会优先往那里放，但PATH也得同步加上它
所有环境变量冲突都藏在 go env 输出里，出问题第一反应不是重装，而是跑一遍 go env GOROOT GOPATH GOPROXY 看实际值；PATH 错位和 GOPROXY 漏配是两个最隐蔽又最高频的坑。
