pkg-config 找不到系统库：cgo 编译直接报错
Go 的 cgo 依赖 pkg-config 自动发现 C 库的头文件路径和链接参数，但默认不继承 shell 的 PKG_CONFIG_PATH，导致 #include <openssl></openssl> 这类引用直接失败，错误里常带 cannot find -lssl 或 fatal error: openssl/ssl.h: No such file or directory。
根本原因不是没装 OpenSSL，而是 Go 构建时压根没调用或没配对 pkg-config。解决方式不是改 Go 源码，而是控制构建环境：
-
CGO_ENABLED=1必须显式开启（交叉编译或某些 CI 环境默认关） -
PKG_CONFIG_PATH要在go build命令前导出，比如export PKG_CONFIG_PATH="/usr/local/lib/pkgconfig:/opt/homebrew/lib/pkgconfig" - macOS 上 Homebrew 安装的库默认不在标准路径，
/opt/homebrew/lib/pkgconfig（Apple Silicon）或/usr/local/lib/pkgconfig（Intel）必须手动加 - Linux 下若用
apt install libssl-dev，pkg-config --modversion openssl能返回版本才说明可用；否则可能只装了运行时库，缺.pc文件
CGO_CFLAGS 和 CGO_LDFLAGS 手动补参数时的坑
当 pkg-config 不可用或想绕过它时，有人会直接写 CGO_CFLAGS="-I/usr/include/openssl"，但这极易出错——头文件路径和链接库路径必须严格匹配，且不能漏掉依赖链上的其他库（比如 libssl 依赖 libcrypto）。
典型翻车场景：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 只加
-lssl却没加-lcrypto，链接时报undefined reference to `CRYPTO_malloc' -
-I指向的是源码目录而非安装后的include目录，比如误用/usr/src/openssl/include（不存在） - 混用不同架构的路径，如在 ARM64 机器上硬塞
x86_64-linux-gnu的库路径 - 忘记加
-fPIC（尤其静态链接时），导致relocation R_X86_64_32 against `...` can not be used when making a shared object
交叉编译时 pkg-config 完全失效怎么办
用 GOOS=linux GOARCH=arm64 go build 时，宿主机的 pkg-config 会去查本地 x86_64 的 .pc 文件，结果路径全错。这不是 Go 的 bug，是 pkg-config 本身不支持跨平台查询。
可靠做法只有两个：
- 用目标平台的
pkg-config工具链，例如arm64-linux-gnu-pkg-config，并设PKG_CONFIG=arm64-linux-gnu-pkg-config - 彻底放弃自动发现，用
CGO_CFLAGS/CGO_LDFLAGS硬编码目标系统的路径（需提前在目标环境跑pkg-config --cflags --libs openssl记下结果） - 注意：Docker 多阶段构建中，build 阶段必须安装对应架构的 dev 包（如
apt-get install libssl-dev:arm64），否则.pc文件根本不存在
go.mod 中 //go:cgo_ldflag 注释不生效的真相
有人在 Go 文件顶部写 //go:cgo_ldflag "-lssl -lcrypto"，以为能替代环境变量，但实际无效——//go:cgo_* 指令只影响当前文件，且仅支持有限指令（cgo_imports, cgo_pkg_config），cgo_ldflag 是假指令，Go 官方根本不识别。
真正有效的注释只有：
-
// #cgo LDFLAGS: -lssl -lcrypto（注意是#cgo，不是//go:cgo） // #cgo CFLAGS: -I/usr/include/openssl- 这些必须紧贴
import "C"前，且每行一个指令，不能合并 - 但强烈不建议这么写：路径写死导致代码不可移植，多人协作时容易因本地路径差异编译失败
cgo 的系统库绑定本质是环境问题，不是代码问题。最稳的方式永远是配对好 pkg-config 路径，而不是在 Go 源码里埋各种条件编译开关。
