如何在 CGO 中安全地将 C 结构体数组传递到 Go 并正确切片访问

本文详解如何通过 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, %dn", 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

✅ 推荐实践总结

记住：CGO 是桥梁，不是护栏。每一次 unsafe.Pointer 转换，都要求你以 C 程序员的严谨承担内存责任。