c代码必须嵌入而非调用：需用/ /紧贴import "c"上方书写，禁空行、禁//注释、禁go语句；字符串传参须c.cstring+c.free；结构体/数组须用c.struct_xxx和指针；头文件路径用#cgo cflags:-i指定。

C 代码不是“调用”的，是“嵌入”进 Go 文件的；没写对位置、格式或漏掉 import "C"，编译器就当它不存在——这是 90% 的 undefined: C.xxx 错误根源。

Go 文件顶部的 C 代码块必须严格满足格式

CGO 解析器只认一种写法：/* */ 包裹的 C 代码，紧贴 import "C" 上方，中间**不能有空行、不能有 Go 语句、不能用 // 注释**。

• 错例：在 /* */ 前加了 // #include <stdio.h></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"</stdio.h>

字符串传参必须用 C.CString + C.free

Go 字符串底层是只读 slice，C 函数接收 char* 后若缓存指针、异步访问或长期持有，下一次 GC 就可能让地址失效——崩溃或读到乱码。

Golang Uber Dig

使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等

下载

• 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; }——字段顺序、填充、对齐规则完全不同，跨平台尤其危险。

• 一律用 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 解析规则。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！