Go二进制默认静态链接，不依赖libc等系统库（除非启用cgo），故可直接运行于scratch镜像；需禁用cgo并显式指定GOOS=linux确保跨平台兼容性。
为什么 Go 二进制不需要运行时依赖？
Go 默认静态链接，
产出的是单个可执行文件，不依赖
、
等系统库（除非显式启用
）。这是多阶段构建能大幅减小镜像体积的根本前提。
常见错误：没关
就往
里塞二进制，启动报
——其实是动态链接器缺失，不是文件没找到。
确认是否静态编译：
输出
才安全
强制静态构建（推荐）：
如果必须用
（如调用 C 库），就别用
，改用
并安装对应依赖
Dockerfile 多阶段写法（Go 官方推荐模式）
典型结构是「构建阶段 + 运行阶段」，中间不保留任何 Go 工具链或源码。
关键点在于：第一阶段用
（或对应版本）做编译；第二阶段用
或
拷贝二进制，不复制
、
、测试文件等无关内容。
立即学习
“
go语言免费学习笔记（深入）
”；
go语言参考手册 中文CHM版
Go 是一个开源的编程语言，它能让构造简单、可靠且高效的软件变得容易。本文给大家带来Go参考手册，需要的可以来下载！ Go是从2007年末由Robert Griesemer, Rob Pike, Ken Thompson主持开发，后来还加入了Ian Lance Taylor, Russ Cox等人，并最终于2009年11月开源，在2012年早些时候发布了Go 1稳定版本。现在Go的开发已经是完全开放的，并且拥有一个活跃的社区。 Go 语言特色 简洁、快速、安全 并行、有趣、开源 内存管理、v数组安全、编译
下载
是命名构建阶段，供后续
引用
必须显式指定，否则在 macOS/Windows 上构建会生成宿主机平台二进制
只能拷贝已存在的文件路径，不能用通配符或相对路径别名
如何避免 COPY 失败或运行时 panic？
最常踩的坑是路径不一致或权限问题。构建阶段生成的二进制若带调试符号或未 strip，可能在
中因缺少
或
导致某些日志/trace 功能失败，但不会直接 crash。
检查二进制是否真能运行：
，而不是只看
是否成功
如果程序用
或读取当前目录配置，需注意
镜像无默认工作目录，务必用
显式设置
Web 服务监听要绑定
，不能写
，否则容器内无法被外部访问
时间区问题：
无
，
仍可用，但
会返回 error
要不要加 .dockerignore？
要，而且非常关键。不加会导致
阶段意外包含
、
、
等大目录，显著拖慢构建速度，甚至触发内存溢出。
最小必要
内容：
特别注意：
后若仍保留
目录，又没加进
，Docker 会把它一并发送给 daemon，而
默认优先用 vendor，容易掩盖模块版本不一致问题。
go buildlibcglibccgocgoscratchno such file or directoryldd your-binarynot a dynamic executableCGO_ENABLED=0 go build -a -ldflags '-extldflags "-static"' -o app .cgoscratchalpine:latestgolang:1.22-alpinescratchalpine$GOPATHgo.modFROM golang:1.22-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -a -ldflags '-extldflags "-static"' -o /usr/local/bin/app .
FROM scratch
COPY --from=builder /usr/local/bin/app /app
EXPOSE 8080
CMD ["/app"]
AS builder--fromGOOS=linuxCOPY --from=builderscratch/proc/dev/nulldocker run --rm -it your-image /app -hdocker buildos.Getwd()scratchWORKDIR0.0.0.0:8080localhost:8080scratch/etc/timezonetime.Now()time.LoadLocation("Asia/Shanghai")go buildnode_modules.gitvendor.dockerignore**/*.md
**/*.txt
.git
.gitignore
README*
Dockerfile
.dockerignore
node_modules
vendor
*.go~
go mod vendorvendor/.dockerignorego build