go命令找不到的根本原因是PATH未包含Go安装路径，需确认/usr/local/go/bin（Mac/Linux）或C:\Go\bin（Windows）是否在PATH中，缺失则添加并source配置或重启终端。
go 命令找不到？先查 PATH 和安装路径是否对齐
终端敲 go version 报 command not found: go，不是 Go 没装，而是 shell 根本没找到它。Mac 和 Linux 默认不把 /usr/local/go/bin 加进 PATH；Windows 安装时若没勾选 “Add Go to PATH”，也会出现同样问题。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先确认安装位置：
ls -d /usr/local/go/bin（Mac/Linux）或检查安装向导是否写入了C:\Go\bin（Windows） - 再看当前
PATH是否包含该路径：echo $PATH（Mac/Linux）或echo %PATH%（Windows） - 如果缺失，追加到 shell 配置文件：
export PATH=$PATH:/usr/local/go/bin（Zsh 用户改~/.zshrc；Windows 用户在系统环境变量里手动添加） - 改完必须
source ~/.zshrc或重启终端，否则不生效
go mod tidy 失败？重点盯 GOPROXY 和 GO111MODULE
go mod tidy 卡住、报 no required module provides package 或一堆 could not download，大概率是模块代理或模块开关没开。Go 1.16+ 默认开启模块模式，但某些旧脚本或 CI 环境仍可能关闭它。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 强制启用模块：
go env -w GO111MODULE=on - 国内用户必须设代理：
go env -w GOPROXY=https://goproxy.cn,direct - 私有仓库要加例外：
go env -w GOPRIVATE=git.company.com/*（否则会走代理失败） - 验证设置是否生效：
go env | grep -E "(GO111MODULE|GOPROXY|GOPRIVATE)"
GOROOT 和 GOPATH 还要手动配吗？看你的 Go 版本和项目类型
Go 1.16+ 已默认使用 $HOME/go 为 GOPATH，且 GOROOT 通常由安装程序自动设好。但如果你用 go install 装工具（如 golangci-lint），或跑老项目（pre-Go Modules），GOPATH/bin 仍得进 PATH，否则命令找不到。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 新项目（Go Modules）：不用显式设
GOPATH，但建议保留export PATH=$PATH:$HOME/go/bin，方便运行本地安装的 CLI 工具 - 老项目（
src/pkg/bin目录结构）：必须设GOPATH，且go get下载的包会进$GOPATH/src - 永远不要手动改
GOROOT——除非你装了多个 Go 版本并用goenv切换；误改会导致go build找不到标准库
Goland import 报红但 go run 正常？IDE 没读你的 shell 环境变量
这是 Goland 最经典的“双环境”问题：终端里 go env 看着全对，IDE 里 import 全红。根本原因是 Goland 启动时没加载你的 ~/.zshrc 或 ~/.bash_profile，所以 PATH、GOPROXY 全丢了。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Preferences > Go > Go Modules > Environment 里，手动填上：
GOPROXY=https://goproxy.cn,direct和GO111MODULE=on - Preferences > Appearance & Behavior > System Settings > Terminal > Shell path 改成
/bin/zsh（或你实际用的 shell），确保终端和 IDE 共享同一套环境 - 重启 Goland —— 不是重载项目，是彻底退出再打开，否则环境变量不会刷新
- 如果用了
direnv或asdf，Goland 默认不识别，必须在 IDE 的 Environment 字段里显式复制变量值
go mod、go get）必须在模块开启、代理可用的前提下执行。漏掉任意一环，都会变成“看起来装好了，实际跑不通”。 
