CGO_ENABLED=0在含import "C"时会直接报错，因Go强制要求启用cgo模式；此时必须配齐目标平台C工具链、头文件路径和库文件路径，缺一不可。
不能直接用 CGO_ENABLED=0 一关了事——只要代码里有 import "C" 或依赖 net/os/user 等隐式 cgo 包，就必须配对目标平台的 C 工具链。
为什么 CGO_ENABLED=0 在含 C 依赖时会直接报错
只要源码中出现 import "C"（哪怕注释里没写任何 C 代码），Go 就判定启用 cgo 模式。此时设 CGO_ENABLED=0，构建会立刻失败，报错类似：gcc: command not found 或 cannot use cgo when CGO_ENABLED=0。
- 错误不是偶然：这是 Go 的硬性限制，不是环境没配好
- 第三方包可能偷偷带
import "C"，用go list -f '{{.CgoFiles}}' ./...可快速扫描 - net、os/user、os/signal 等标准库在 CGO_ENABLED=0 时行为退化（如 DNS 解析不读
/etc/resolv.conf），不是“编译过去就能跑”
启用 CGO 交叉编译必须配齐三样东西
缺一不可，少一个就会静默链接失败或运行时报 undefined reference：
-
CC_<target>环境变量：比如CC_aarch64_linux_gnu="aarch64-linux-gnu-gcc"，告诉 Go 用哪个 C 编译器 - 对应架构的头文件：放在独立目录（如
./deps/arm64/include），通过// #cgo CFLAGS: -I${SRCDIR}/deps/arm64/include显式引入 - 对应架构的库文件（
.so或.a）：同样放独立目录（如./deps/arm64/lib），用// #cgo LDFLAGS: -L${SRCDIR}/deps/arm64/lib -lfoo
注意：${SRCDIR} 是 cgo 内置变量，自动展开为当前 .go 文件所在路径，别硬写绝对路径。
立即学习“go语言免费学习笔记（深入）”；
不同平台交叉编译 C 工具链安装示例
别指望系统自带 gcc 能跨架构编译——它只能编译本机 CPU 架构的 C 代码。
- Linux x86_64 → Linux arm64：
sudo apt install gcc-aarch64-linux-gnu，再设CC_aarch64_linux_gnu="aarch64-linux-gnu-gcc" - macOS → Linux amd64：进 Docker 容器更稳，避免本地 clang 干扰：
docker run --rm -v "$(pwd)":/work -w /work golang:1.22-alpine sh -c "apk add build-base && go build -o myapp ." - macOS/Linux → Windows amd64：装
gcc-mingw-w64，设CC_x86_64_w64_mingw32="x86_64-w64-mingw32-gcc"
验证工具链是否生效：运行 aarch64-linux-gnu-gcc --version 这类命令，不能报 “command not found”。
动态库名和符号导出必须严格匹配
就算工具链和路径都对了，undefined reference to 'xxx' 还是常出现——大概率是 C 库本身没导出你要的符号。
- 动态库文件名必须以
lib开头、.so（Linux）或.dll（Windows）结尾，例如libfoo.so，不能叫foo.so - 用
nm -D libfoo.so | grep orig_func（Linux）或objdump -t libfoo.dll | grep orig_func（Windows）确认符号真实存在且未被 strip - C 头文件里声明的函数签名（参数类型、const 修饰等）必须和库中导出的完全一致，差一个
const都会导致链接失败
最容易被忽略的是：C 库编译时是否加了 -fPIC（位置无关代码），否则在 Go 中链接动态库会失败。
