根本原因是shell未找到go可执行文件而非go未安装；先用ls /usr/local/go/bin/go（linux/macos）或dir c:\go\bin\go.exe（windows）确认文件是否存在，再用which go或where go查系统当前识别路径，结合检查path配置与shell配置文件是否正确加载。
go 命令报 command not found 怎么确认根本原因
这不是 Go 没装好，而是 shell 根本没找到 go 这个可执行文件。先别急着重装，直接查真实路径：
- 运行
ls /usr/local/go/bin/go（Linux/macOS）或dir C:\Go\bin\go.exe（Windows），看文件是否存在 - 如果存在，说明 PATH 没加对；如果不存在，说明解压/安装路径错了
- 用
which go或where go查系统当前“以为”的位置，常会返回空或指向旧残留 - Zsh 用户改
~/.zshrc，Bash 用户改~/.bashrc，别漏掉source ~/.zshrc这一步
常见陷阱：PATH 里写了 /usr/local/go 却漏了 /bin；或者改了错误的配置文件（比如用了 fish 但去改 .zshrc）。
go env 显示 GOROOT 错误怎么办
go env GOROOT 输出不是你实际安装路径（比如显示 /home/user/go），说明它被覆盖了。这不是偶然，是配置文件里写了硬编码。
- 搜所有 shell 配置：
grep -r "GOROOT=" ~/.zshrc ~/.profile ~/.bashrc ~/.bash_profile 2>/dev/null - 删掉类似
export GOROOT=$HOME/go的行——GOROOT 应由安装自动推导，手动设极易出错 - 检查项目根目录下有没有
go.env或.env文件，它们可能通过go env -w或工具链注入了错误值 - 清掉缓存再验证：
go clean -modcache && go env -u GOROOT（-u 表示 unset）
GOROOT 被错设后，go install 可能试图往只读目录写二进制，直接报 permission denied。
go run 或 go build 报 “cannot find package” 怎么定位
这个错误表面是包找不到，实际分两类：模块模式下路径错，或 GOPATH 模式下结构不合规。
- 先运行
go env GOPATH和go env GO111MODULE：如果GO111MODULE=off，说明你在用老式 GOPATH 模式，但项目又不在$GOPATH/src下，必然失败 - 如果
GO111MODULE=on，检查go.mod是否在项目根目录；导入语句里的路径必须和module声明完全一致（包括大小写） - 本地模块引用要靠
replace：比如replace github.com/xxx => ./local-lib，路径必须是相对当前go.mod的，不能用绝对路径 - 编辑器提示错但命令行能跑？多半是 IDE 没 reload workspace，或 gopls 缓存脏了，试
go mod vendor后重启编辑器
特别注意：go get 在模块模式下默认从远程拉，不会自动识别同目录下的子模块——必须显式 replace 或 require 并指定版本。
go install 写入 /usr/lib/go/bin 权限拒绝怎么修
这说明 GOBIN 或 GOPATH 没生效，工具链 fallback 到了 GOROOT 下的 bin 目录，而那里需要 root 权限。
- 运行
go env GOBIN：如果为空，就手动设export GOBIN=$HOME/go/bin（别依赖 GOPATH/bin 自动推导） - 确保
$HOME/go/bin目录存在且属当前用户：mkdir -p $HOME/go/bin && chown -R $(whoami) $HOME/go - 检查是否用
sudo解压过 Go：ls -ld $HOME/go若 owner 是 root，必须sudo chown -R $(whoami) $HOME/go - 验证：运行
go install fmt，然后ls $HOME/go/bin/fmt，文件应存在且可执行
最易忽略的一点：即使设置了 GOPATH，GOBIN 优先级更高；只要 GOBIN 为空，go install 就会尝试写 GOPATH/bin，而如果 GOPATH 本身也没设，就会退到 GOROOT —— 这条 fallback 链就是权限问题的根源。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
