cgo调用C库必须显式启用且严格遵循顺序：先C注释块（含#include和函数声明），紧接import "C"，再#cgo指令；路径、声明、链接参数缺一不可，否则报undefined reference或file not found。
cgo 调用 C 库不是“装完 Go 就能跑”，必须显式启用、路径对、声明全、链接准——漏任何一环都会卡在 undefined reference 或 file not found。
CGO 必须手动开启且 import "C" 位置不能错
cgo 不是默认激活的。即使写了 #include，没有 import "C" 就完全不生效；而且它必须紧贴在 C 代码块（注释块）之后，中间不能有空行或 Go 代码。
-
import "C"前面只能是 C 风格注释（/* ... */或连续的//行），不能夹杂package main、变量声明等 Go 语法 - 常见错误：把
import "C"写在文件开头，后面才放/* #include "xxx.h" */—— 这样 C 代码块根本不会被识别 - 正确顺序一定是：
/* #include ... */→ 紧接着import "C"
#cgo 指令必须紧邻 C 代码块且无空行
// #cgo 注释不是普通注释，它是编译器指令，只对紧随其后的 C 代码块生效。一旦中间出现空行，上下文就断了。
- 错误写法：
// #cgo CFLAGS: -I/path/to/include→ 空行 →/* #include "wn.h" */→import "C"；此时wn.h会在默认系统路径里找，必然失败 - 正确写法：所有
// #cgo行必须连续，且最后一行// #cgo和/*之间**不能有空行** - 多个参数要分行写：
// #cgo CFLAGS: -I./csrc -DDEBUG比拼成一行更易维护，但不能换行中断指令流
C 函数声明必须出现在 import "C" 上方的注释块里
cgo 不解析外部 .h 文件内容，只认你亲手写进注释块里的 C 声明。头文件只是帮你抄写的参考，不是自动包含源。
立即学习“go语言免费学习笔记（深入）”；
- 不能只写
/* #include "algo.h" */就指望C.process可用——如果algo.h里只有int process();，链接时仍会报undefined reference to 'process' - 必须显式写出完整原型：
int process(const int*, size_t);，或确保#include的头文件路径正确、内容可被 C 编译器直接 parse - C++ 库需加
extern "C"包裹声明，否则函数符号被 mangling，C.some_func找不到对应符号 - 依赖标准头文件（如
stdlib.h）也要一并#include，不能假设隐式存在
静态库链接失败？-l 参数和实际文件名不匹配是主因
cgo 默认优先找动态库（.so/.dylib），放个 libalgo.a 在旁边也不会自动用——除非你明确告诉它“我要静态链接”，且名字、路径、架构全对。
-
// #cgo LDFLAGS: -L./libs -lalgo中的-lalgo对应的是libalgo.a（Linux/macOS）或algo.lib（Windows），不是algo.a - macOS 上静态链接需额外加
-Wl,-force_load,./libs/libalgo.a；Linux 上用-static-libalgo或-Wl,--whole-archive -lalgo -Wl,--no-whole-archive - 交叉编译时注意目标平台架构：x86_64 的
.a无法用于 arm64 构建，file format not recognized错误往往源于此
最常被忽略的其实是 C 代码块里的细节：头文件路径是否相对正确、#include 顺序是否引发宏冲突、extern "C" 是否漏加、C.CString 是否配对 C.free……这些都不报语法错，但会让程序在运行时崩或内存持续增长。调用 C 库不是“连上就行”，而是每一步都要对齐 C 编译器的视角。
