C.some_func报undefined是因cgo只认import "C"上方注释块中C可解析的原型声明，字符串传入崩溃主因是C.CString未配对C.free，微服务OOM多由C堆内存泄漏导致；根本在于Go与C内存规则冲突，必须严格划清边界并手动管理生命周期。
C.some_func 报 undefined？不是函数没写，是 Go 根本没看见声明；字符串传进去后程序崩？大概率 C.CString 没配对 C.free；微服务跑几天就 OOM？十有八九是 C 堆内存泄漏没清理。cgo 调用本身不难，难在边界守不住——Go 和 C 各有一套内存规则，混着用又不划清责任，出事只是时间问题。
为什么 C.some_func 总是 undefined
cgo 不读 .c 文件，只认 import "C" 上方紧贴的注释块里能被 C 编译器解析的原型声明。头文件路径、内容、格式全得对上，漏一环就链接失败。
-
/* #include "algo.h" */必须和.go文件在同一目录；若algo.h在./csrc/下，得写/* #include "../csrc/algo.h" */或加// #cgo CFLAGS: -I./csrc - 头文件里不能只写
int process();，必须是完整签名：int process(const int* data, size_t len); - 如果
algo.h依赖<stdlib.h></stdlib.h>，得显式包含：/* #include <stdlib.h> #include "algo.h" */</stdlib.h> - C++ 实现的算法库，头文件里必须用
extern "C"包裹函数声明，否则名字被 mangling，C.process就找不到符号
字符串和切片怎么传才不崩溃
Go 的 string 是只读不可变结构，底层不以 \0 结尾；C 函数直接收 char* 会越界或 panic。别图省事直接传，必须转换且生命周期可控。
- 输入字符串：用
C.CString(s)→ 得立刻defer C.free(unsafe.Pointer(cstr))；但注意：循环里不能写defer，要改成for内手动C.free - 输入字节切片（推荐）：用
C.CBytes([]byte(s))返回unsafe.Pointer，再转(*C.char)，显式传长度；它不扫描\0，比C.CString快，也避免空字符截断 - 输出字符串：C 函数返回
char*时，优先用C.GoStringN(cstr, n)（n 是 C 侧明确返回的长度），而不是C.GoString(cstr)——后者会调strlen扫描，遇到中间\0就截断 - 绝对不要把
C.CString结果存进 map、全局变量或 channel，defer 失效，内存永远不释放
静态库 libalgo.a 链接总失败
cgo 默认找动态库（.so/.dylib），同目录放了 libalgo.a 也不认——除非你明说“我要静态链接”，而且路径、名字、架构全对。
立即学习“go语言免费学习笔记（深入）”；
-
// #cgo LDFLAGS: -L./libs -lalgo中的-lalgo对应的是libalgo.a（Linux/macOS）或algo.lib（Windows），不是algo.a - 强制静态：macOS 加
-Wl,-force_load,./libs/libalgo.a；Linux 加-static-algo（GCC）或直接写绝对路径// #cgo LDFLAGS: ./libs/libalgo.a - 交叉编译时，
libalgo.a必须是目标平台 ABI 编译的（比如darwin/arm64库不能给linux/amd64用） - 链接顺序敏感：
-lA -lB表示 A 依赖 B，那 B 必须写在 A 右边；微服务里若算法库依赖 OpenSSL，则-lssl -lcrypto要放在-lalgo后面
微服务场景下如何避免内存泄漏和并发踩坑
单次调用不出事，高并发+长周期运行的微服务里，C 堆内存不释放、指针跨 goroutine 乱传、C 函数重入不安全，三者叠加就是稳定复现的 panic。
- 每个请求分配的 C 内存（如
C.CString、C.CBytes、C.malloc）必须在该请求结束前释放——别依赖 finalizer，它不保证时机，可能 GC 前 C 库已反复用了这块内存 - C 函数若非线程安全（很多老算法库默认不加锁），Go 侧必须自己加
sync.Mutex或用runtime.LockOSThread()绑定 OS 线程（慎用，影响调度） - 回调函数必须用
//export my_callback+C.callback注册，不能直接传 Go 函数值；且回调里别调println、log这类可能触发 GC 的操作 - 结构体传参用
C.struct_algo_config{...}，字段名大小写、顺序必须和 C 端完全一致；取地址传参必须写&C.struct_algo_config{...}，少个&就是值拷贝，C 侧改了你也收不到
真正麻烦的从来不是“怎么调通”，而是“调通之后，流量上来、跑三天、压测峰值时，哪块 C 内存没 free、哪个指针被两个 goroutine 同时写了”。cgo 没魔法，它只是把两套规则并排放你面前——你得自己画那条线，并始终踩在线内。
