“no such file or directory”并非文件路径错误，而是容器缺少运行时依赖——如glibc版本不匹配或CGO_ENABLED=1导致动态链接libc，而alpine仅含musl；典型报错为standard_init_linux.go:178: exec user process caused "no such file or directory"。
go build 报 “no such file or directory” 是 libc 或动态链接问题
这个错误不是真的找不到文件，而是容器里缺少运行时依赖——典型如 glibc 版本不匹配，或二进制是用 CGO_ENABLED=1 编译的，但基础镜像（比如 alpine）只有 musl libc。错误日志里出现 standard_init_linux.go:178: exec user process caused "no such file or directory" 就是这个信号。
解决方式很简单：强制静态编译，绕过系统 libc 依赖：
-
CGO_ENABLED=0必须设在go build前，不是环境变量全局设置就完事；多阶段构建中尤其要写在 RUN 行里 - 搭配
GOOS=linux，避免 macOS/Windows 上直接go build生成非 Linux 二进制 - 如果必须用 CGO（比如调用 OpenSSL 或数据库驱动），就别用
alpine，改用debian:slim或ubuntu:22.04这类带完整glibc的镜像
Docker 构建时 go mod download 失败或找不到 go.mod
现象是 go: no required module provides package main 或 go: no go files in current directory。根本原因不是 Go 代码有问题，而是构建上下文（build context）没把 go.mod 带进去。
常见踩坑点：
立即学习“go语言免费学习笔记（深入）”；
-
.dockerignore里写了**/*.go或go.mod，直接把关键文件过滤掉了 - Dockerfile 放在子目录（如
deploy/Dockerfile），但执行docker build -f deploy/Dockerfile .时，.是项目根目录，而COPY . .没提前COPY go.mod go.sum ./，导致go mod download阶段找不到模块定义 - 多服务项目中，
build.context设成了.，但某个服务的go.mod其实只在./svc/api下
正确做法：先 COPY go.mod go.sum ./，再 RUN go mod download，最后才 COPY . . —— 这样能利用 Docker 层缓存，且确保模块解析有依据。
go run 在容器里启动失败，或者一跑就 panic
本地开发时图省事把 go run main.go 写进 CMD，进容器后大概率失败。原因很实在：容器内没有 go 环境（除非你用了 golang 镜像当运行时），也没有 GOPATH、GOROOT 或模块缓存。
更隐蔽的问题是：
-
go run启动的进程监听127.0.0.1:8080，容器外根本连不上；必须改成":8080"或"0.0.0.0:8080" - 没处理
SIGTERM，Kubernetes 或docker stop时无法优雅退出，连接被硬杀 - 没加重试逻辑，
depends_on只管容器启没启，不管 DB 是否 ready，一上来就 dial 失败 panic
生产环境永远用预编译二进制，开发环境可用 air + volume 挂载源码，而不是在容器里跑 go run。
交叉编译参数没生效，本地构建的二进制在容器里报 syntax error
错误信息像 /app/engine: 1: /app/engine: Syntax error: "(" unexpected，这不是 Go 语法错，是 ELF 格式不识别——说明你在 macOS 上执行了 go build -o engine，生成的是 Mach-O 文件，Linux 容器内核压根不认。
关键不是“能不能编译”，而是“编译目标对不对”：
-
GOOS和GOARCH必须显式传给go build，不能只靠环境变量；例如GOOS=linux GOARCH=amd64 go build -o engine . - Makefile 里用
GOOS ?= linux是方便覆盖，但实际构建命令里仍要带上，否则 Make 不会自动注入到子 shell - CI/CD 流水线里如果混用 Mac 节点构建 Linux 镜像，必须加这组参数，否则必然失败
最稳的方式是：所有构建动作都在 Linux 环境做，或者统一用多阶段 Docker 构建，彻底规避宿主机干扰。
