cgo 不提供 go 类型（如 interface、struct）到 c 的直接映射，也不存在类似 jni.h 的标准头文件；正确做法是统一以 c 类型为桥梁，在 go 中封装 c 结构体，并通过 cgo 导出函数时仅传递 c 兼容类型。
cgo 不提供 go 类型（如 interface、struct）到 c 的直接映射，也不存在类似 jni.h 的标准头文件；正确做法是统一以 c 类型为桥梁，在 go 中封装 c 结构体，并通过 cgo 导出函数时仅传递 c 兼容类型。
在 CGO 编程中，一个常见误区是试图将 Go 的高级类型（如 interface{}、自定义 struct 或 GoInterface）直接暴露给 C 代码使用。实际上，
Go 官方明确不支持、也不保证 Go 运行时类型的 C 可见性或内存布局稳定性
。你遇到的编译错误：
正是因为 GoInterface 并非真实存在的 C 类型——它仅是 cgo 工具链在生成导出符号时内部使用的伪类型，
不会被导出为 C 头文件中的可引用标识符
，也没有配套的 供包含。
✅ 正确实践：以 C 类型为中心，双向桥接
推荐采用“C 优先”设计：先在 C 端定义清晰、稳定的结构体，再在 Go 中封装为 type X struct { c C.x }，所有跨语言调用均基于该 C 类型：
a.h
a.c
a.go
⚠️ 关键注意事项：
禁止传递 Go interface{}、[]byte、map、chan 或任意 Go struct 指针给 C
：它们无 C 对应布局，且受 GC 影响，极易导致崩溃。
基础类型映射有限但可靠
：int, int64, float64, *C.char 等可安全互通；但 int 在不同平台宽度不一，建议显式使用 C.int / C.int64_t。
内存管理必须明确归属
：C 分配的内存（如 malloc）应由 C 函数（如 free 或自定义 DestroyMyData）释放；Go 分配的内存（如 C.CString）需手动 C.free。
若必须传递复杂数据，用序列化替代
：如 JSON 字节流（*C.char + C.size_t 长度）或 FlatBuffers，而非尝试伪造结构体内存布局。
总结：CGO 的互操作不是“类型对等”，而是“契约协作”。始终以 C 头文件为权威接口定义，Go 端做安全封装与转换——这是稳定、可维护、符合 Go 内存模型的唯一推荐路径。
a.h:1:16: error: unknown type name 'GoInterface'#ifndef A_H
#define A_H
typedef struct {
int id;
char* name;
} MyData;
// 接收并返回 C 结构体指针（安全、标准）
MyData* SomeFunc(MyData* arg);
#endif#include "a.h"
#include
#include
MyData* SomeFunc(MyData* arg) {
if (!arg) return NULL;
MyData* result = malloc(sizeof(MyData));
result->id = arg->id + 1;
result->name = strdup(arg->name ? arg->name : "default");
return result;
} package main
/*
#cgo CFLAGS: -std=c99
#cgo LDFLAGS: -lm
#include "a.h"
*/
import "C"
import (
"fmt"
"unsafe"
)
// Go 端封装：持有 C 结构体实例（值语义，避免裸指针生命周期风险）
type MyData struct {
c C.MyData
}
// 构造函数：从 Go 值初始化 C 结构体
func NewMyData(id int, name string) *MyData {
cName := C.CString(name)
defer C.free(unsafe.Pointer(cName))
return &MyData{
c: C.MyData{
id: C.int(id),
name: cName,
},
}
}
// 调用 C 函数（传入 &c，返回新封装实例）
func (m *MyData) Process() *MyData {
resC := C.SomeFunc(&m.c)
if resC == nil {
return nil
}
// 注意：C.SomeFunc 返回的内存需由 C 侧管理（如 free），此处仅为示例
// 实际中建议 C 函数提供 destroy 接口，或改用 Go 分配+拷贝
return &MyData{c: *resC}
}
func main() {
data := NewMyData(42, "hello")
result := data.Process()
if result != nil {
fmt.Printf("ID: %d, Name: %s\n", int(result.c.id), C.GoString(result.c.name))
}
}