cgo的preamble必须紧邻import "c"且连续，空行会截断导致头文件找不到；#cgo指令须在注释块前无空行；独立.c文件需手动编译链接或内联到注释块；macos默认禁用c-shared模式。
import "C" 前的注释块必须连续，空行会直接导致头文件找不到
cgo 不是“读取 Go 文件里的 C 代码”，而是把 import "C" 正上方紧挨着的注释块（/* ... */ 或连续的 // #include）当作 C 的 preamble 提交给 C 编译器。一旦中间出现空行、Go 代码或非注释内容，preamble 就被截断——后面 #include "wn.h" 实际在默认系统路径下查找，自然报 fatal error: 'wn.h' file not found。
常见错误写法：
// #cgo CFLAGS: -I/usr/local/WordNet-3.0/include // #cgo LDFLAGS: /usr/local/WordNet-3.0/lib/libWN.3.dylib <p>/<em> #include "wn.h" </em>/ import "C"</p>
这里 // #cgo 和 /* 之间有空行，CFLAGS 不生效。正确写法必须物理连续：
// #cgo CFLAGS: -I/usr/local/WordNet-3.0/include
// #cgo LDFLAGS: /usr/local/WordNet-3.0/lib/libWN.3.dylib
/* #include <stdio.h>
#include "wn.h"
static int get_synset_count() { return wn_maxsynsets(); }
*/
import "C"</stdio.h>
-
// #cgo指令和/*之间不能有任何空行 - 多个
#include必须写在同一块注释里，不能拆成两段/* */ -
// #cgo CFLAGS和// #cgo LDFLAGS必须放在 preamble 之前，且彼此之间也不能空行
调用外部 .c 文件时，cgo 默认不编译它们
你写了 hello.c，又在注释里 #include "hello.h"，但编译时报 undefined reference to 'say_hello'——这不是链接失败，是根本没编译 hello.c。cgo 只处理注释块里的 C 代码，对独立 .c 文件完全无视。
两种解法：
- 最简单：把 C 实现直接塞进注释块，比如
/* void say_hello() { puts("hi"); } */ - 想分离源码：先用
gcc -c hello.c -o hello.o编译出目标文件，再用// #cgo LDFLAGS: ./hello.o显式链接 - 别写
// #include "hello.c"——C 编译器会把它当头文件解析，立刻报语法错
CGO_ENABLED=1 不是万能钥匙，macOS 上 c-shared 默认禁用
执行 go build -buildmode=c-shared -o libgo.so 在 macOS 上大概率失败，错误类似 building dynamic library is not supported on darwin。这不是配置问题，是 Go 官方限制：macOS 默认关闭 c-shared 支持。
即使强制开启（CGO_ENABLED=1 go build -buildmode=c-shared），也极易因隐式依赖崩溃：
- 只要用了
net、http、os/exec、任何go f()或reflect，就会引入runtime.xxx符号，导致undefined symbol - c-shared 模式下，Go 运行时需由宿主 C 程序显式调用
runtime._cgo_init，而标准工具链不生成 glue code - 若真要动态库，只保留纯计算逻辑，禁用 GC 相关操作（避免
make([]byte, 1、不用 <code>defer）
C.CString 分配的内存必须手动 free，且不能跨调用复用
C.CString 返回的是新分配的 *C.char，生命周期完全独立于 Go 字符串。不 C.free 就内存泄漏；free 早了（比如在 C 函数返回前）会导致段错误；存起来复用更危险——同一块内存可能被多次 free 或已释放后继续访问。
典型安全写法：
func callCWithStr(s string) {
cs := C.CString(s)
defer C.free(unsafe.Pointer(cs)) // defer 在函数退出时 free
C.some_c_func(cs)
}
- 绝不在多个 C 调用间复用同一个
C.CString返回值 - 不要把
*C.char存到全局变量或结构体字段里长期持有 - 如果 C 函数内部会保存指针并异步使用，必须用
C.CBytes+ 手动管理生命周期，或改用 Go 分配 +C.copy
真正麻烦的不是语法，而是那些看不见的边界：preamble 的物理连续性、.c 文件的显式编译、macOS 对动态库的硬性限制、C 字符串生命周期的精确控制——这些点稍一松懈，编译通过但运行崩，或者运行正常但内存持续泄漏。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
