答案是PATH未配置Go的bin目录。go version报“command not found”说明系统找不到go命令，根本原因是PATH环境变量未包含Go安装路径下的bin目录，如Windows的C:\Go\bin或macOS/Linux的/usr/local/go/bin，需手动添加并重载shell配置。
go version 检查失败，说明 PATH 没配对
执行 go version 报 “command not found” 或 “无法识别的命令”，基本就是 PATH 里没包含 Go 的 bin 目录。Windows 默认装到 C:\Go\bin，macOS/Linux 通常是 /usr/local/go/bin 或自定义路径（比如 $HOME/sdk/go/bin）。别只改 GOROOT 或 GOPATH，那俩不影响命令能否调用。
验证方式：直接运行 which go（macOS/Linux）或 where go（Windows PowerShell），没输出就说明 PATH 漏了。补上后记得重启终端或重新加载 shell 配置（source ~/.zshrc）。
Docker 构建时 go build 找不到 main 包
常见于 Dockerfile 中 COPY 路径写错，或工作目录没设对。比如 WORKDIR /app 后 COPY . .，但项目里没有 main.go，或 main.go 在子目录里却没 COPY 进来。
实操要点：
立即学习“go语言免费学习笔记（深入）”；
-
go build必须在包含package main和至少一个func main()的目录下执行 - 如果用
go build ./cmd/myapp，确保./cmd/myapp是个独立包且含main - 容器内调试：加
RUN ls -R和RUN go list ./...看实际结构 - 避免
COPY . .复制整个宿主目录——可能带node_modules或.git，用.dockerignore过滤
go run 与 go build 在容器里行为不一致
go run 是边编译边运行，依赖源码；go build 输出二进制，不依赖源码。容器里用 go run 很容易失败，因为：
- 它默认只找当前目录下的
*.go文件，不会递归扫描子目录 - 如果项目用了 Go Modules，但
go.mod不在当前WORKDIR，会报no Go files in current directory - 容器里没装编辑器、调试器等开发工具链，
go run也没必要——上线镜像该用go build产物
建议：开发阶段本地用 go run，Docker 构建阶段一律用 go build -o /app/myapp，然后 CMD ["/app/myapp"]。
多阶段构建中 CGO_ENABLED=0 容易被忽略
最终镜像用 alpine 或 scratch 时，如果没关 CGO，go build 会链接 libc，导致运行时报 not found 或 No such file or directory（其实是动态库缺失）。
正确姿势：
- 构建阶段保持
CGO_ENABLED=1（默认），确保能正常go get和编译 - 最后阶段显式设
CGO_ENABLED=0：ENV CGO_ENABLED=0，再go build - 加
-a -ldflags '-extldflags "-static"'强制静态链接（可选，但更稳妥） - 验证：用
file /app/myapp看输出是否含statically linked
这个开关不只影响 Alpine 镜像——任何无完整 C 运行时的精简镜像都得关。
