go version报command not found，根本原因是PATH未正确配置/usr/local/go/bin；需确认go二进制存在、编辑对应shell配置文件添加export PATH=$PATH:/usr/local/go/bin并source生效。
go version 显示命令未找到？检查 PATH 是否漏加 /usr/local/go/bin
装完 Go 二进制包却执行 go version 报错 command not found: go，90% 是因为 PATH 没生效或写错了路径。
常见错误包括：export PATH=$PATH:/usr/local/gobin（漏了斜杠）、export PATH=/usr/local/go/bin（没拼接原 PATH）、编辑了 /etc/profile 却在普通用户下用 ~/.bashrc 测试。
- 确认解压位置：运行
ls /usr/local/go/bin看是否存在go可执行文件 - 临时测试：直接运行
/usr/local/go/bin/go version，能输出即说明安装没问题 - 永久生效：往
~/.bashrc或~/.zshrc（根据你 shell 类型）追加export PATH=$PATH:/usr/local/go/bin，然后source ~/.bashrc - 别用
/etc/profile给单用户配 PATH —— 它只对 root 或 login shell 生效，普通终端启动的是 non-login shell
go env GOPATH 为空？别手动设 GOPATH，除非你真需要旧式工作区
Go 1.16+ 默认启用模块（modules），GOPATH 不再是必须项。但如果你看到 go env GOPATH 输出空值，不是 bug，而是 Go 已切换到模块模式。
真正要关心的是：GO111MODULE 是否为 on，以及当前目录是否有 go.mod 文件。
立即学习“go语言免费学习笔记（深入）”；
- 运行
go env GO111MODULE，输出on才表示模块启用；若为auto或off，执行go env -w GO111MODULE=on - 新建项目时，先
mkdir myapp && cd myapp，再go mod init myapp，会自动生成go.mod - 只有当你明确要复用旧项目结构（如依赖
$GOPATH/src下的包）才需设GOPATH；否则建议保持默认，避免路径冲突 - 如果设了
GOPATH，记得也把$GOPATH/bin加入 PATH，否则go install生成的命令找不到
go build -o 生成的二进制无法在目标机器运行？查 GOOS/GOARCH 和 cgo
本地编译出的二进制，在另一台 Linux 机器上提示 cannot execute binary file: Exec format error，大概率是架构不匹配；若提示 not found（指动态库），则可能启用了 cgo。
Go 默认静态链接，但一旦引入 C 代码（比如用 net 包做 DNS 解析、或调用系统库），就会依赖 libc，导致跨发行版不兼容。
- 交叉编译前先确认目标环境：运行
uname -m（如x86_64、aarch64）和uname -s（如Linux） - 编译命令示例：
GOOS=linux GOARCH=arm64 go build -o app-linux-arm64 . - 禁用 cgo 可强制静态链接：
CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o app-static . - 验证二进制类型：
file app-static应显示statically linked；ldd app-static应输出not a dynamic executable
go install 安装后命令找不到？确认 $GOPATH/bin 在 PATH 里且权限正确
go install 成功但终端打不出命令名，不是安装失败，而是 shell 找不到可执行文件位置。
关键点在于：go install 默认把二进制放到 $GOPATH/bin（模块模式下是 $GOBIN，若未设则 fallback 到 $GOPATH/bin），而不是当前目录。
- 运行
go env GOPATH和go env GOBIN，看输出路径是否一致；若GOBIN为空，就看GOPATH下的bin/目录 - 检查该目录是否存在且有执行权限：
ls -l $(go env GOPATH)/bin，确认生成的文件权限含x - 确保
$(go env GOPATH)/bin已加入 PATH —— 这步常被忽略，尤其当GOPATH设在非默认路径（如/opt/go）时 - 别用
go install ./...而不指定包路径；正确写法是go install ./cmd/mytool@latest或进入包目录后go install
version `GLIBC_2.34' not found。 
