cgo CFLAGS必须写在import "C"前面，因为CGO解析器按行扫描，遇到import "C"即停止读取前置注释块；若CFLAGS写在其后或中间有空行，指令被忽略，导致头文件找不到、编译失败。
为什么#cgo CFLAGS必须写在import "C"前面
因为CGO解析器是按行扫描的，遇到import "C"就停止读取前面的注释块。如果// #cgo CFLAGS: -I./include写在import "C"之后，或者中间夹了空行，整个指令会被忽略——编译时找不到头文件，报错use of undeclared identifier或fatal error: xxx.h: No such file or directory。
- 必须紧贴
import "C"上方，且两者之间不能有任何空行 -
// #include也得在同一注释块里，否则头文件声明和编译参数脱节 - 路径用相对路径更安全，比如
-I./include比-I/usr/local/include/mylib更容易跨环境迁移
pkg-config比硬编码CFLAGS更可靠
硬编码// #cgo CFLAGS: -I/usr/include/openssl看似简单，但一旦OpenSSL装在非标准路径（比如自定义/opt/openssl），构建就失败。用pkg-config能自动适配安装位置，前提是库提供了.pc文件且PKG_CONFIG_PATH已设好。
- 写法是
// #cgo pkg-config: openssl，一行搞定头文件和链接参数 - 多个库用空格分隔：
// #cgo pkg-config: openssl zlib sqlite3 - 验证是否生效：运行
go build -x，看输出里gcc命令是否包含pkg-config --cflags openssl调用 - 没装
pkg-config或.pc文件缺失时，会静默失败——建议加个go:build cgo约束并文档注明依赖
交叉编译时头文件路径容易错配
本地开发用amd64，但目标是arm64设备，这时候// #cgo CFLAGS: -I./include可能指向主机头文件，而非目标平台的。GCC交叉工具链自带的sysroot才是正确路径。
- 用
// #cgo CFLAGS: --sysroot=/path/to/arm64/sysroot -I/path/to/arm64/sysroot/usr/include - 避免混用主机和目标头文件，否则编译通过、运行时崩溃（比如
struct timespec大小不一致） - Go 1.21+ 支持
GOOS=linux GOARCH=arm64 CGO_ENABLED=1，但必须同步配置C交叉工具链，不能只靠Go参数 - 推荐在CI中用Docker镜像统一工具链，比如
golang:1.23-bookworm+gcc-arm-linux-gnueabihf
C++头文件需要额外处理
Go本身不理解C++语法，// #include <string>直接写会报错expected identifier or '(', found 'template'。必须用extern "C"包裹，且确保C++头文件被C编译器可见。
立即学习“go语言免费学习笔记（深入）”；
- 不能写
// #include <string>，要写/* extern "C" { #include <string> } */ - C++实现必须导出C符号，比如
extern "C" void my_cpp_func();，否则C.my_cpp_func链接失败 - 如果C++头文件依赖STL，需确保CFLAGS里有
-std=c++17，但CGO默认用C模式编译——得用// #cgo CPPFLAGS: -std=c++17 - 混合项目里，
.h放C接口，.hpp放C++实现，Go只include前者
头文件路径看着只是加个-I，但背后牵扯到编译器查找顺序、交叉工具链sysroot、C/C++语言模式切换，以及pkg-config的环境一致性。最容易被忽略的是注释块格式和空行——它不报语法错误，只让配置彻底失效。
