go install 报 command not found 的根本原因是 $path 未包含 $goroot/bin 或 $gopath/bin；需确认 go 安装路径，将对应 bin 目录加入 path，并 source 配置文件（如 ~/.zshrc）使其生效，再通过 which go 和 echo $path 验证。
go install 为什么找不到命令
常见现象是执行 go install 报错 command not found，本质不是 Go 没装好，而是 $PATH 没包含 $GOROOT/bin 或 $GOPATH/bin。Linux/macOS 用户容易漏掉 source ~/.zshrc（或 ~/.bashrc）这一步；Windows 用户则常把 %GOROOT%\bin 写错路径或没刷新环境变量。
验证方式：运行 which go 看是否返回路径；再运行 echo $PATH | grep -E "(go|GOROOT|GOPATH)" 检查关键目录是否在其中。若缺失，补上后重载 shell 配置即可。
- Ubuntu/Debian 推荐用
sudo tar -C /usr/local -xzf go*.tar.gz解压，然后在~/.zshrc中加：export GOROOT=/usr/local/go和export PATH=$PATH:$GOROOT/bin - macOS 若用 Homebrew 安装，
brew install go后通常自动配置，但 M1/M2 芯片需确认是否为arm64架构版本，否则go install可能静默失败 - Windows 下 MSI 安装器默认设好
GOROOT，但若自定义路径，必须手动添加%GOROOT%\bin到系统 PATH，且重启终端
GOOS=linux GOARCH=amd64 go build 为何生成的二进制在目标机器上跑不起来
交叉编译看似简单，但实际运行失败往往因为忽略了 libc 兼容性或静态链接开关。Alpine 镜像用的是 musl libc，而默认 go build 生成的是 glibc 链接的可执行文件，直接丢进 Alpine 容器会报 not found 错误。
解决办法是显式启用静态链接：CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -o myapp。这样生成的二进制不依赖外部 libc，真正“开箱即用”。
-
CGO_ENABLED=0是关键，它禁用 cgo，避免动态链接；但代价是失去 sqlite、openssl 等需 C 库支持的功能 - 若必须用 cgo（比如调用 C 代码），则需在目标环境（如 Alpine）中安装对应开发包，并用
docker build在相同基础镜像中编译 - macOS 编译 Linux 二进制时，
GOARCH=arm64对应 AWS Graviton 实例，别误写成arm（那是 32 位旧架构）
go mod init 后 go run 却提示 cannot find module providing package
这不是模块初始化失败，而是当前目录不在 $GOPATH/src 且未启用 Go Modules 时的老问题。Go 1.16+ 默认开启 modules，但如果你在非模块根目录下执行 go run main.go，Go 会尝试向上查找 go.mod，找不到就报这个错。
正确做法是确保 go.mod 文件存在且位于项目根目录；如果已存在，检查是否被 .gitignore 忽略导致未提交；更隐蔽的问题是当前 shell 工作目录与 IDE 打开路径不一致——VS Code 经常以父目录为工作区，导致 go run 在错误路径执行。
- 初始化模块：在项目根目录运行
go mod init example.com/myapp，别用本地路径如./myapp - 确认
go.mod第一行是module example.com/myapp，不是空行或注释 - VS Code 中右键文件 → “Open in Integrated Terminal”，再
go run，避免路径错位
Termux 或 Docker 里 go build 出来的文件为啥不能直接执行
Termux 是 Android 上的 POSIX 环境，Docker 容器是隔离的 rootfs，两者都可能缺执行权限或 ABI 不匹配。Termux 默认 umask 是 0022，go build 生成的文件没有 +x 权限；Docker 里若挂载了 Windows 主机目录，NTFS 的权限元数据会丢失，导致 chmod 失效。
最稳妥的做法是显式加权限并验证架构：go build -o server && chmod +x server && file server。输出里看到 ELF 64-bit LSB executable, x86-64 才算对路。
- Termux 中构建后务必
chmod +x，Android SELinux 限制严格，没执行位直接拒绝 - Docker 多阶段构建时，builder 阶段用
golang:1.21-alpine，final 阶段用alpine:latest，但 final 阶段的COPY --chmod=755必须显式声明权限 - ARM 设备（树莓派、M1 Mac）上编译的二进制，不能直接扔到 x86_64 服务器跑，
file命令一眼就能看出区别
file 一下，ls -l 一下，go env 一下，比反复重装 Go 有用得多。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
