Go默认静态链接，但CGO_ENABLED=1时会动态链接系统库；彻底静态需设CGO_ENABLED=0并加-a -ldflags '-s -w'，否则net/os等包仍引入libc依赖。
Go 默认构建就是静态链接的，但“项目静态构建”常被误解为：打包全部依赖（含 C 库）、不依赖系统动态库、生成单文件可执行体。真正要解决的是这三类问题：CGO 依赖导致动态链接、外部资源未嵌入、跨平台交叉编译时环境污染。
确认 CGO_ENABLED=0 是否真生效
Go 在 CGO_ENABLED=1（默认）时会链接 libc 等系统库，哪怕你没写一行 C 代码——只要标准库中用了 cgo（如 net 包 DNS 解析、os/user 查用户），就会引入动态依赖。
- 运行
ldd your-binary，若输出含libc.so.6或libpthread.so.0，说明没完全静态 - 强制禁用 cgo：
CGO_ENABLED=0 go build -a -ldflags '-s -w' -o myapp . -
-a强制重新编译所有依赖（包括标准库），确保无残留 cgo 调用；-s -w去除调试符号减小体积 - 注意：
CGO_ENABLED=0下net包会回退到纯 Go DNS 解析器（使用 /etc/resolv.conf），且无法调用getpwuid等系统调用——若项目需解析主机名或查当前用户名，得改用net.DefaultResolver或显式传入 IP
静态链接 C 库（如 readline、sqlite3）
当你必须用 CGO_ENABLED=1（例如依赖 GNU Readline 的 CLI 工具），又想避免部署时缺 libreadline.so，就得手动静态链接 C 源码。
- 不能只放
.a文件进项目——go build不识别传统静态库路径，必须让 cgo 看到源码 - 把 C 库源码（如 readline-8.2/）整个复制进
./csrc/，同时带入生成的config.h和所有.c/.h - 在 Go 文件顶部写 cgo 指令：
// #include "readline.h" // #include "config.h" // #cgo CFLAGS: -I./csrc -DHAVE_CONFIG_H // #cgo LDFLAGS: -L./csrc/.libs -lreadline -lncurses import "C"
- 关键：
-L必须指向编译好的.a所在目录（不是源码目录），且libreadline.a需已用ar打包好；-lncurses这类底层依赖也得一并静态提供，否则链接失败
嵌入 HTML/JS/CSS 等静态资源
Web 服务或 CLI 工具常需自带前端资源，但 go:embed 只处理编译期文件，不解决运行时路径漂移问题。
立即学习“go语言免费学习笔记（深入）”；
- 别用
os.Open("static/index.html")—— 这依赖外部文件，破坏“单文件”目标 - 正确做法：
import "embed" //go:embed static/* var assets embed.FS func handler(w http.ResponseWriter, r *http.Request) { f, _ := assets.Open("static/index.html") http.ServeContent(w, r, "index.html", time.Now(), f) } - 注意：
embed.FS是只读虚拟文件系统，不支持Write；若需运行时生成文件（如日志），仍得走真实磁盘路径 - 大文件（如 >10MB 的 JS bundle）会显著拖慢
go build速度，建议用zlib压缩后嵌入，启动时解压到临时目录再 serve
交叉编译时避免本地 libc 污染
在 macOS 上构建 Linux 二进制，若未禁用 cgo，可能链接到 macOS 的 libSystem.dylib，导致 Linux 上直接报错 not found。
- 最稳妥方式：用
docker run --rm -v $(pwd):/work golang:1.26-alpine go build -o myapp-linux . - Alpine 镜像默认
CGO_ENABLED=0，且不含 glibc，天然产出纯静态二进制 - 若必须用 glibc 环境（如依赖某些 C 库的符号），则需在容器内安装对应
gcc和musl-gcc工具链，并显式指定CC=musl-gcc - 验证：在目标系统上运行
file myapp-linux，输出含statically linked才算真正静态
真正难的不是“怎么加参数”，而是判断哪些依赖必须妥协（比如放弃 os/user.Current 改用硬编码用户名）、哪些 C 库值得花半天手撕 config.h 和 Makefile 兼容层——这些决策点，往往比写代码更消耗时间。
