cgo编译失败而go build不报错是因为cgo默认关闭，需显式启用cgo_enabled=1；若未设置或环境变量丢失、gcc不可用、交叉编译未配cc_for_target、头文件路径未用// #cgo cflags: -i指定、动态库未用-l指定路径等，均会导致失败。
为什么 cgo 编译失败，但 go build 没报错？
因为 cgo 默认是关闭的。哪怕代码里写了 #include <stdio.h></stdio.h>，只要没显式启用，Go 就当它不存在——不报错，也不编译 C 部分。
启用方式很简单：CGO_ENABLED=1 go build。但问题常出在环境变量没传进子 shell 或 CI 环境里被清空。本地测试时建议直接写全命令，别依赖 shell 别名或 profile 里的默认值。
-
CGO_ENABLED=0时，import "C"会直接报错：unknown import path “C” -
CGO_ENABLED=1但找不到gcc，错误是：exec: "gcc": executable file not found in $PATH - 交叉编译时（比如 macos 编译 linux 二进制），
CGO_ENABLED=1会强制失败，除非配好对应平台的CC_for_target
macOS 上装了 xcode Command Line Tools，为什么 gcc 还是找不到？
macOS 的 gcc 实际是 clang 的符号链接，但 Go 在调用时会严格检查编译器输出里的 gcc 字样。Xcode 自带的 gcc 不输出这个标识，导致 cgo 拒绝使用。
解决办法不是重装 GCC，而是告诉 Go 用哪个编译器：CC=clang go build。更稳妥的是设环境变量：export CC=clang，再运行构建命令。
立即学习“go语言免费学习笔记（深入）”；
- 验证当前生效的 C 编译器：
go env CC - 如果用 Homebrew 装了真正的
gcc-13，要写全路径：CC=/opt/homebrew/bin/gcc-13 - Clang 对 C11 支持足够，多数 C 库无需换编译器，硬切 GCC 反而容易触发 ABI 不兼容
#include 找不到头文件，-I 参数怎么加才生效？
不能靠系统 CPATH 或裸写 #include "xxx.h"，Go 的 cgo 只认 // #cgo CFLAGS: -I/path/to/headers 这种注释指令。
注意两件事：路径必须是绝对路径，或相对于当前 .go 文件的相对路径；多个 -I 要写在同一行注释里，用空格分隔。
- 错误写法：
// #cgo CFLAGS: -I./include（相对路径在某些 GOPATH 模式下可能失效） - 推荐写法：
// #cgo CFLAGS: -I${SRCDIR}/include -I/usr/local/include（${SRCDIR}会被自动替换为源文件所在目录） - 如果头文件在
$HOME/mylib/include，别写~，用$HOME或全路径，否则cgo不展开
Linux 下动态链接 .so 文件总提示 undefined reference
这不是链接顺序问题，而是 cgo 默认只做静态链接推导。即使你写了 // #cgo LDFLAGS: -lfoo，它也不会自动找 libfoo.so 的位置。
必须显式告诉链接器库文件在哪：// #cgo LDFLAGS: -L/path/to/lib -lfoo。而且 -L 必须出现在 -l 之前，顺序不能颠倒。
-
-L路径优先级高于系统/usr/lib，适合覆盖系统旧版本库 - 如果库有依赖（比如
libfoo.so依赖libbar.so），要一并写上：-L/path -lfoo -lbar - 运行时报
libfoo.so: cannot open shared Object file？那是LD_LIBRARY_PATH没设，和编译无关
事情说清了就结束。最常卡住的地方其实是环境变量没传进构建上下文，以及头文件路径用了 shell 展开符却忘了 cgo 不解析它们。