go version报command not found，说明path未包含$goroot/bin；linux/macos需在~/.zshrc或~/.bash_profile中添加export path=$path:$goroot/bin并source，windows需手动将c:\go\bin加入系统path。
go version 命令没反应，PATH 没配对
执行 go version 报错 command not found，说明 shell 找不到 go 可执行文件。这不是 Go 没装好，而是 $GOROOT/bin 没加进 PATH。
Linux/macOS 下检查当前 PATH：echo $PATH
看输出里有没有类似 /usr/local/go/bin 或 /usr/local/Cellar/go/1.21.1/libexec/bin 这样的路径。
- 如果没出现，编辑
$HOME/.profile（或$HOME/.zshrc，取决于你用的 shell），追加两行： -
export GOROOT=/usr/local/go（替换成你实际解压的路径） export PATH=$PATH:$GOROOT/bin- 保存后运行
source $HOME/.profile（或source $HOME/.zshrc）立即生效 - Windows 用户注意：
go.exe默认装在C:\Go\bin，安装时勾选“Add Go to PATH”即可；若没勾，需手动在系统环境变量里把该路径加进Path
go env 显示 GOPATH 是空的，但 go mod 仍能工作
go env GOPATH 输出为空，不代表出问题——从 Go 1.16 开始，GO111MODULE=on 已默认启用，模块模式不再强制依赖 GOPATH。只要项目根目录下有 go.mod 文件，go get、go build 就会走模块路径，下载到 $GOMODCACHE（通常是 $HOME/go/pkg/mod）。
真正需要关心的是：
-
go env GOMODCACHE是否可写（尤其在 root 用户下首次运行时，可能因权限被拒导致缓存失败） -
go env GOPROXY是否设为国内镜像，比如https://goproxy.cn,direct；否则go get会卡在proxy.golang.org - 若仍想显式设置
GOPATH（例如兼容老项目），只需加一行export GOPATH=$HOME/go到 shell 配置文件，并确保$GOPATH/bin也在PATH里（否则go install的二进制找不到）
go get github.com/spf13/cobra 失败：timeout 或 checksum mismatch
这是国内网络环境下最典型的依赖安装失败场景，根本原因不是包本身有问题，而是代理或校验机制拦截了中间环节。
先确认是否已配置代理：
- 运行
go env GOPROXY，如果不是https://goproxy.cn,direct或https://mirrors.aliyun.com/goproxy/,direct，立刻设置：go env -w GOPROXY=https://goproxy.cn,direct - 再试
go get github.com/spf13/cobra@latest；如果还失败，加-v看具体卡在哪一步：go get -v github.com/spf13/cobra - 若提示
checksum mismatch，说明本地缓存的校验数据和远程不一致，直接清掉：go clean -modcache - 极少数情况下（如公司内网禁用了 TLS SNI），需临时关闭校验：
go env -w GOSUMDB=off（仅调试用，上线前务必关掉）
go run main.go 提示 “cannot find package”
这个错误通常出现在刚初始化模块后，或误删了 go.mod。Go 不是靠目录结构找依赖，而是靠 go.mod 声明的 module path 和依赖版本。
检查三件事：
- 当前目录下是否有
go.mod？没有就运行go mod init example.com/myapp（module 名可任意，但建议用域名+项目名） -
go.mod里是否已有对应依赖？比如require github.com/spf13/cobra v1.8.0；如果没有，别手动写，用go get触发自动添加 - 代码里
import的路径是否和go.mod中的 module name 匹配？例如import "github.com/spf13/cobra"必须和go.mod第一行的module example.com/myapp无关，只认 import 路径本身
模块路径和 import 路径是两套逻辑，混淆这点最容易反复踩坑。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
