Go默认静态链接，ldd显示“not a dynamic executable”却报libpq.so.5找不到，本质是启用了CGO_ENABLED=1但未提供运行时so路径；真需动态链接须加-ldflags '-extldflags "-shared"'。
Go 默认不支持动态链接，所谓“动态链接编译失败”，本质是误启了 cgo + 外部共享库依赖，但没配对工具链或运行时环境。 直接用 CGO_ENABLED=0 go build 静态打包，95% 的场景根本不需要动态链接。
为什么 ldd 显示 not a dynamic executable 却还报 libpq.so.5 找不到？
这是最典型的认知错位：你没真正触发动态链接，只是编译时启用了 cgo（CGO_ENABLED=1），又没提供 libpq.so.5 运行时路径，导致程序启动时报错——但二进制本身仍是静态链接的（ldd 说 “not a dynamic executable” 就是铁证）。
- 确认是否真需要 libpq：如果只是连 PostgreSQL，优先用纯 Go 驱动
github.com/jackc/pgx/v5，完全规避 cgo - 若必须用
lib/pq（它依赖 libc 和 libpq），则必须设CGO_ENABLED=1，且目标机器装好对应版本的libpq.so.5 - 想让
go build输出带动态依赖的二进制，得加-ldflags '-extldflags "-shared"'——但注意，这不会自动帮你装 so，只是放弃默认静态行为 -
go run永远静态链接，动态链接只能靠go build，别在go run里试
CGO_ENABLED=1 时编译失败：gcc 找不到 -lmingw32 或 -lopus
错误不是 Go 的问题，而是 C 工具链和你要链接的库不匹配。比如 Windows 上用 Cygwin 的 gcc 去链 MinGW 库，或 Linux 上没装 libopus-dev 就直接写 #cgo LDFLAGS: -lopus。
- 先执行
go env CC看当前 C 编译器路径；若含cygwin或msys，大概率是它在捣鬼 - Linux 下缺库：运行
apt install libopus-dev（Ubuntu/Debian）或yum install opus-devel（CentOS/RHEL） - Windows 下推荐换 TDM-GCC：卸载 Cygwin/MSYS 的 gcc，装 TDM-GCC（带完整 mingw32/mingwex/pthread），再
go env -w CC="C:\TDM-GCC-64\bin\gcc.exe" - 用
go build -x查看完整 gcc 调用命令，复制出来手动执行，能快速定位是头文件还是库文件缺失
如何彻底静态打包，连 glibc 都不要？
两个可靠路径：一是关 cgo，二是强制 external linker 静态链接。前者更干净，后者兼容部分 cgo 场景。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
-
CGO_ENABLED=0 go build -o myapp -ldflags '-w -s'：最简方案，适用于 net/http、database/sql（用 pgx）、encoding/json 等纯 Go 生态 -
CGO_ENABLED=1 go build -o myapp -ldflags '-w -s -extldflags "-static"'：保留 cgo，但要求所有 C 依赖都提供静态库（如libpq.a），且系统装了gcc和glibc-static（CentOS）或libc6-dev-i386（Ubuntu 多架构） - 交叉编译时别碰
CGO_ENABLED=1：比如在 x86_64 机器上GOOS=linux GOARCH=arm64 CGO_ENABLED=1必然失败，因为没 arm64 版本的 gcc 和系统库 - 验证是否真静态：
ldd ./myapp输出 “not a dynamic executable”，且file ./myapp含 “statically linked”
embed 打包前端资源时常见卡点
//go:embed 是 Go 1.16+ 官方方案，但它对语法和路径极其敏感，错一个空格就编译不过。
-
//go:embed注释必须**紧挨着**变量声明，中间不能有空行或注释 - 路径是相对于
.go文件所在目录的，不是项目根目录；写assets/*前先确认该目录真实存在 - 变量类型只能是
embed.FS、[]byte或string；多文件必须用embed.FS，单文件才可用[]byte - 嵌入后访问需桥接：用
http.FS(assets)转成http.FileSystem，不能直接传assets给http.FileServer - 若资源含中文名或特殊字符，确保文件系统编码为 UTF-8，且 Go 源码保存为 UTF-8 without BOM
真正麻烦的从来不是怎么写命令，而是搞清你到底要不要 cgo、要不要外部 so、要不要跨平台——这三个问题没想清楚，所有参数都是白调。
