<p>C.xxx报undefined的根本原因是cgo未识别C声明，因Go编译器不解析#include，仅紧贴import "C"上方、用/ /包裹且无中断的注释块有效，中间插空行、//注释或Go语句均导致失效。</p>
能调用，但绝大多数“调用失败”不是函数写错了，而是 cgo 根本没看见你的 C 声明——它只认紧贴 import "C" 上方那一块连续的注释，中间插个空行、写行 // log 或放个 var x int，C.xxx 就直接报 undefined。
import "C" 前的注释块必须连续且纯净
cgo 不解析 Go 文件里的 C 代码，它只把 import "C" 正上方、未被中断的注释块（/* */ 或以 // #cgo 开头的行）当作 C preamble 提交给 C 编译器。一旦中断，整块失效。
-
/* #include <stdio.h> */ import "C"</stdio.h>✅ 有效 -
/* #include <stdio.h> */</stdio.h>（空行）import "C"❌ 失效：空行截断 preamble -
// #include <stdio.h></stdio.h>❌ 单行注释不被 cgo 解析（除非是// #cgo指令） - 头文件若依赖
stdlib.h，必须显式写进同一块注释：/* #include <stdlib.h> #include "mylib.h" */</stdlib.h> - C++ 头文件必须用
extern "C"包裹，否则函数名被 mangling，C.xxx消失无踪
独立 .c 文件不会自动编译，得手动告诉 cgo
cgo 默认只处理注释块里的 C 代码，同目录下的 hello.c 完全被忽略。你看到的 undefined reference 错误，不是链接失败，是那个 .c 根本没编译过。
- 最简方案：把 C 实现塞进注释块，比如
/* void say_hello() { puts("hi"); } */ - 想分离源码？先用
gcc -c hello.c -o hello.o编译成目标文件，再在注释里加：// #cgo LDFLAGS: ./hello.o - 别写
// #include "hello.c"——C 编译器会把它当头文件处理，报语法错 - 如果用了
// #cgo CFLAGS: -I./inc，它也得和 C 声明块之间无缝衔接，不能有空行
C 字符串传参后 free 的时机由 C 侧决定，不是 Go 能猜的
C.CString 返回的是新分配的 *C.char，Go 不管它的生命周期。free 早了崩溃，不 free 就泄漏，存到 map 或全局变量里更危险——defer 失效，没人负责回收。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 最安全模式：
cstr := C.CString(s); defer C.free(unsafe.Pointer(cstr))——适用于 C 函数只读、不保存指针的场景 - 如果 C 函数内部调用了
strdup或长期持有该指针（比如注册回调），你就不能C.free，得看 C 侧文档 -
C.GoString返回的是 Go 堆副本，它不 touch 原始*C.char，哪怕刚转完，原始指针仍需你自己C.free - 绝对不要把
C.CString结果存进map[string]*C.char或 channel ——内存归属彻底失控
链接静态库 libxxx.a 时符号找不到？默认优先找动态库
cgo 在 Linux/macOS 上默认搜索 libxxx.so 或 libxxx.dylib，即使当前目录放着 libxxx.a，它也视而不见，除非你明确指定路径和链接方式。
-
// #cgo LDFLAGS: -L./libs -lxxx中的-lxxx对应的是libxxx.a（Linux/macOS）或xxx.lib（Windows），不是xxx.a - 强制静态链接：写死路径，如
// #cgo LDFLAGS: ./libs/libxxx.a - macOS 上还得多加
-Wl,-force_load,，否则未引用的符号会被 strip：// #cgo LDFLAGS: -Wl,-force_load,./libs/libxxx.a - 交叉编译时，静态库必须是目标平台 ABI 编译的，否则报
file not recognized: file format not recognized
最常被忽略的其实是“连续性”——从 /* 开始到 import "C" 之前，不能有任何非注释内容、不能有空行、不能混 Go 代码。这不是风格问题，是 cgo 的硬性解析规则。一旦断开，整个 C 上下文就丢了，后面所有调用都会静默失败。
