1. 原理综述：Go 指针与 C 指针的边界与规则
1.1 指针生命周期与内存模型
在 CGO 场景中，Go 指针和 C 指针遵循截然不同的内存模型，Go 的对象可能随垃圾回收（GC）而移动，因此在跨语言边界上需要显式管理生命周期。
核心要点：Go 指针不应被 C 代码长期持有，除非在 C 端仅在单次调用内使用，并且不在回调中存储它。这可以避免 GC 误判或对象被提前回收的风险。
当把 Go 指针传给 C 时，GC 的可嗅探性和对象的分配区域（栈/堆）需要被充分考虑，以确保调用边界内的引用是安全的。
package main
/*
#include
void take_ptr(int* p);
*/
import "C"
import ("unsafe"
)func main() {v := 42// 将 Go 指针传递给 C，生命周期限定在一次调用内C.take_ptr((*C.int)(unsafe.Pointer(&v)))
}
1.2 CGO 的编译与运行时约束
CGO 在构建时会生成桥接代码，确保 Go 的垃圾回收器在 C 调用期间不会错误地收集仍在使用的对象。编译期约束包括需要在代码中使用 import "C" 并通过注释块声明 C 函数原型。
运行时约束强调：在 C 调用和返回之间，Go 的栈和堆对象不应被 GC 进行异常移动。跨语言调用的生命周期边界必须清晰，否则容易出现悬空指针或数据竞争。
package main
/*
#include
void print_ptr(int* p);
*/
import "C"
import "unsafe"func main() {n := 100// 将 Go 变量地址传给 C，注意仅在调用期间使用C.print_ptr((*C.int)(unsafe.Pointer(&n)))
}
2. 转换技巧：从原理到实战
2.1 直接传递指针的可行性与风险
直接将 Go 指针作为参数传递给 C 是可行的，但有严格的使用边界。C 端必须仅在当前调用期间使用该指针，且不能在返回后继续引用，避免 GC 和内存生命周期冲突。
在实际场景中，若 C 端需要长期或跨调用持有数据，应优先采用数据拷贝、或在 C 侧分配内存来承载数据，而非直接持有 Go 指针。
package main
/*
#include
void process(int* p, int n);
*/
import "C"
import "unsafe"func main() {a := []int{1, 2, 3, 4}// 将 Go 切片的首元素指针传给 C，确保 C 不会在此之外使用它C.process((*C.int)(unsafe.Pointer(&a[0])), C.int(len(a)))
}
2.2 使用 cgo.Handle 安全托管 Go 值
当需要在 C 端持有 Go 侧对象的引用时，推荐使用 cgo.Handle。它将 Go 值注册到一个全局句柄表中，C 端只持有一个 uintptr_t 句柄，而不是直接持有 Go 指针，从而避免 GC 的移动或回收带来的问题。
通过暴露一个 Go 回调接口，C 端可以通过句柄调用回传数据，Go 侧通过 h.Value() 拿到原始对象。注意在适当时机释放句柄，以避免内存泄漏。
package main
/*
#include
void c_use_handle(uintptr_t h);
*/
import "C"
import ("runtime/cgo"
)type Worker struct {ID int
}func main() {w := &Worker{ID: 7}h := cgo.NewHandle(w)C.c_use_handle(C.uintptr_t(h))// h.Delete() // 根据实际回调时机进行释放
}
2.3 避免悬空指针与 GC 逃逸
为了避免悬空指针和 GC 逃逸，应尽量采用数据拷贝、或在 Go 侧通过托管结构管理数据，而不是让 C 端直接拥有 Go 指针。
若需要跨边界处理大块数据，优先在 Go 侧分配内存并拷贝到 C，或在 C 侧进行本地分配后再回写，从而减少 GC 对 Go 对象的影响。
// C 端的拷贝实现
#include
void c_copy_ints(int* dst, const int* src, int n);
package main
/*
#include
#include
void c_copy_ints(int* dst, const int* src, int n);
*/
import "C"
import ("unsafe"
)func copyInts(dst []int, src []int) {C.c_copy_ints((*C.int)(unsafe.Pointer(&dst[0])), (*C.int)(unsafe.Pointer(&src[0])), C.int(len(src)))
}
void c_copy_ints(int* dst, const int* src, int n) {for (int i = 0; i < n; i++) dst[i] = src[i];
}
2.4 将 C 指针转换为 Go 指针的注意事项
直接将 C 指针转换为 Go 指针并在 Go 侧继续引用，通常是不安全的，容易导致 GC 无法正确跟踪、悬空或数据竞争。应优先使用数据复制、或通过创建 Go 切片/数组来承载从 C 拷贝的数据。
若确有需要跨边界交互，可以通过 unsafe 转换并结合拷贝策略，确保在 Go 侧对数据的生命周期有明确的控制。
package main
/*
#include
void c_get_ints(int* out, int n);
*/
import "C"
import ("unsafe"
)func fetchFromC(n int) []int {out := make([]int, n)C.c_get_ints((*C.int)(unsafe.Pointer(&out[0])), C.int(n))return out
}
