根本原因是path未包含$goroot/bin（linux/macos）或%goroot%\bin（windows），导致系统找不到go命令；需正确配置path、goroot、goproxy，并验证生效。
go version 报 command not found 怎么办
根本原因只有一个：PATH 没包含 $GOROOT/bin（Linux/macOS）或 %GOROOT%\bin（Windows），不是安装失败，而是系统找不到可执行文件。
- Windows 用户：检查系统环境变量
PATH是否明确包含类似C:\Go\bin或C:\Program Files\Go\bin的完整路径——只加C:\Go是无效的 - macOS/Linux 用户：确认
~/.zshrc或~/.bash_profile中有export PATH=$PATH:/usr/local/go/bin，且已运行source ~/.zshrc - 改完必须新开终端验证，旧窗口不会自动加载新
PATH - 验证命令：
echo $PATH（macOS/Linux）或echo %PATH%（Windows），搜索go对应的bin路径是否在其中
go env GOROOT 为空或路径错误
GOROOT 是 Go 自身安装位置，不是你放代码的地方。它为空或错乱时，fmt 等标准库会直接报 cannot find package。
- 不要手动设置
GOROOT，除非你清楚自己在做什么；官方安装包通常已内置正确值 - 若必须设：Linux/macOS 在 shell 配置中加
export GOROOT=/usr/local/go；Windows 在系统变量里新建GOROOT，值为安装目录（不含\bin） - 设完立即运行
go env GOROOT验证，而不是跳过这步直接写代码 - 常见错误路径：
/tmp/go、C:\Users\name\go、/home/user/go—— 这些都不是标准安装位置
go mod download 卡住或 checksum mismatch
不是网络慢，而是代理配置失效或 go.sum 记录与实际内容冲突，尤其在国内环境高频发生。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 先验证代理是否生效：
go env GOPROXY应输出类似https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct - 临时测试：
go mod init example.com/test && go mod tidy，几秒内完成即正常；超时说明代理未起作用 - 遇到
checksum mismatch，别删go.sum或硬跑go mod tidy；先用go mod download -json github.com/some/pkg@v1.2.3查实际校验和来源 - 确认可信后，运行
go mod download github.com/some/pkg@v1.2.3触发自动更新go.sum对应行 - 残留无效条目可用
go mod edit -dropsum清理（Go 1.19+）
VS Code / GoLand 中 gopls 报 cannot find package
这不是插件装错了，是工作区初始化状态不对，gopls 对模块结构极其敏感。
- 打开项目前，确保根目录存在
go.mod；没有就先运行go mod init example.com/foo - 检查
go.mod里是否有replace指向不存在的本地路径，这类错误会导致gopls直接拒绝加载 - VS Code 的
gopls继承 shell 环境变量，改完GOPROXY后需重启整个 VS Code（不只是终端） - GoLand 需手动点击 Settings → Go → GOROOT → “Reload”，或重启 IDE 才刷新代理和模块状态
- 禁用所有非官方 Go 插件（如
go-outline），只保留gopls和dlv
最容易被忽略的是：改了环境变量不新开终端、go.mod 缺失却直接开 IDE、代理设了但没验证是否生效。这些点卡住后，所有后续操作都会层层失效。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
