本文详解如何通过 cgo 将 c 函数返回的 `struct person*` 数组及其长度安全转换为 go 切片，并避免内存泄漏或越界访问。
在 CGO 编程中，C 侧常以指针 + 长度方式返回结构体数组（如 struct Person* get_team(int* n)），而 Go 侧需将其转化为可安全遍历的切片。关键在于：CGO 不提供自动内存管理——你必须显式协调分配与释放时机，并确保切片视图不越界。
正确转换为 Go 切片
假设 C 函数签名如下：
// C side
struct Person { char* name; int age; };
struct Person* get_team(int* n);
Go 侧应这样调用并切片：
package main /* #include// 假设 C 实现已链接 */ import "C" import ( "fmt" "unsafe" ) func main() { var n C.int teamPtr := C.get_team(&n) if teamPtr == nil { panic("get_team returned null") } defer C.free(unsafe.Pointer(teamPtr)) // 必须在切片使用完毕后释放 // 安全切片：基于已知长度 n 创建 slice 视图 teamSize := int(n) // 使用 [1<<30] 作为编译期常量数组大小（不实际分配），再切片 teamSlice := (*[1 << 30]C.struct_Person)(unsafe.Pointer(teamPtr))[:teamSize:teamSize] // 现在可安全遍历 for i, p := range teamSlice { fmt.Printf("Person %d: %s, %d/n", i, C.GoString(p.name), int(p.age)) } }
⚠️ 关键注意事项
- 长度可信性：n 必须由 C 函数准确写入，且调用方不可篡改；建议在 C 中添加断言或日志验证。
- 内存生命周期：defer C.free(...) 必须在所有对 teamSlice 的读取完成后执行；若切片需跨函数传递，应复制数据（如用 make([]Person, teamSize) + 手动字段拷贝）。
- 字符串处理：C 中的 char* 字段（如 name）需用 C.GoString() 转为 Go 字符串，且注意其底层内存仍属 C 分配，不能在 C.free 后访问。
- 零长度保护：始终检查 n
✅ 推荐实践总结
| 场景 | 推荐做法 |
|---|---|
| 短期局部使用 | 直接切片 + defer C.free（如上例） |
| 需长期持有或跨 goroutine | 将 teamSlice 中每个 C.struct_Person 字段逐个复制到 Go struct，再释放 C 内存 |
| 大数组性能敏感 | 避免 C.GoString 频繁分配，改用 unsafe.Slice（Go 1.21+）或 C.CString 反向管理 |
记住：CGO 是桥梁，不是护栏。每一次 unsafe.Pointer 转换，都要求你以 C 程序员的严谨承担内存责任。