<p>C代码必须嵌入而非调用：需用/ /紧贴import "C"上方书写，禁空行、禁//注释、禁Go语句；字符串传参须C.CString+C.free；结构体/数组须用C.struct_xxx和指针；头文件路径用#cgo CFLAGS:-I指定。</p>
C 代码不是“调用”的，是“嵌入”进 Go 文件的；没写对位置、格式或漏掉 import "C"，编译器就当它不存在——这是 90% 的 undefined: C.xxx 错误根源。
Go 文件顶部的 C 代码块必须严格满足格式
CGO 解析器只认一种写法：/* */ 包裹的 C 代码，紧贴 import "C" 上方，中间**不能有空行、不能有 Go 语句、不能用 // 注释**。
- 错例：在
/* */前加了// #include <stdio.h>→ CGO 完全忽略 - 错例：C 代码块和
import "C"之间空了一行 →C.add报未定义 - 错例：把
#include "my.h"写在 Go 的import下面 → 头文件不生效，函数声明找不到 - 正确写法示例：
/*
#include <stdio.h>
#include "mylib.h"
int add(int a, int b) { return a + b; }
*/
import "C"字符串传参必须用 C.CString + C.free
Go 字符串底层是只读 slice，C 函数接收 char* 后若缓存指针、异步访问或长期持有，下一次 GC 就可能让地址失效——崩溃或读到乱码。
-
C.CString(s)分配新内存、复制内容、加\0，返回*C.char - 必须配对
C.free(unsafe.Pointer(ptr))，否则 C 堆内存泄漏 -
defer C.free(...)只保证函数退出时释放，若 C 层异步用该指针，仍属use-after-free - 若 C 函数返回的是静态字符串（如
return "ok";），用C.GoString(cstr)转 Go 字符串即可，不用 free
结构体和数组操作必须用 C.struct_xxx 和指针
Go 不会自动把 type Point struct{ X, Y int } 当成 C 的 struct { int x; int y; }——字段顺序、填充、对齐规则完全不同，跨平台尤其危险。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
立即学习“go语言免费学习笔记（深入）”；
- 一律用
C.struct_point（cgo 自动生成），字段名和类型直接从 C 头文件推导 - 传结构体给 C 函数时，必须传指针：
&p，不能传值p（C 函数收不到修改） - 数组要传首元素地址：
&arr[0]，不能直接传arr（Go 不允许取数组变量地址） - 别手写 Go struct 模拟 C struct，也别用
unsafe.Offsetof算偏移——它反映的是 Go 布局，不是 C 的
编译失败先看 go build -x 输出的 gcc 命令
报 undefined reference to 'xxx' 或 fatal error: xxx.h: No such file，本质是链接或头文件路径没配对。环境变量、#cgo 指令、工具链三者必须一致。
- 确保
CGO_ENABLED=1，交叉编译时更要显式设置，例如：CGO_ENABLED=1 GOOS=linux go build - 头文件路径用
// #cgo CFLAGS: -I/path/to/include，库路径用// #cgo LDFLAGS: -L/path/to/lib -lmylib - 自定义 C 函数（非系统库）必须提供实现：要么放在同一目录的
.c文件里，要么通过LDFLAGS显式链接.so或.a - 用
go build -x查看实际调用的gcc命令，确认-I和-L参数是否包含你的路径
C 代码嵌入位置、字符串生命周期、结构体内存布局、编译参数路径——这四点任何一个出偏差，都会导致静默失败或运行时崩溃。没有“差不多”，只有完全匹配 C ABI 和 cgo 解析规则。
