Go cgo-string 怎么处理C 字符串

在 cgo 里处理 C 字符串，先看 C 端给你的数据有没有可靠的 \0 结尾：有，就用 C.GoString；只有地址和长度，就用 C.GoStringN。反过来把 Go 字符串传给 C，则使用 C.CString，并由调用方负责 C.free。最容易出错的不是函数名，而是把读取边界和内存所有权混在了一起。

官方文档：https://pkg.go.dev/cmd/cgo

先把 C 字符串的三种边界分清

Go 的字符串由地址和长度共同描述，可以包含 NUL 字节；传统 C 字符串通常只是指向字符数组的指针，并把第一个 \0 当成结束位置。因此，C 函数返回的 char* 只有在接口保证 NUL 结尾时，才适合直接交给 C.GoString。

用 C.GoString 读以 \0 结束的内容

下面做一个很小的 cgo 示例：C 侧分配一段带 NUL 结尾的名字，Go 侧读取它。这里的 static 只是让示例函数留在当前 cgo 编译单元中；它不是生产接口的必要条件。

package main

/*
#include 
#include 

// 返回由 C 堆分配、以 NUL 结尾的文本。
static char* make_name(void) {
    const char* src = "sensor-A";
    size_t n = strlen(src);
    char* out = (char*)malloc(n + 1);
    if (out == NULL) return NULL; // 分配失败时让 Go 侧先处理空指针
    memcpy(out, src, n + 1);       // 连同结尾的 NUL 一起复制
    return out;
}
*/
import "C"

import (
    "fmt"
    "unsafe"
)

func main() {
    ptr := C.make_name()
    if ptr == nil {
        panic("C.make_name returned nil") // 不把空指针交给 C.GoString
    }
    defer C.free(unsafe.Pointer(ptr)) // C.CString/C 自己分配的内存由调用方释放

    name := C.GoString(ptr) // 读取到 NUL，并复制成独立的 Go string
    fmt.Printf("name=%q\\n", name)
}

这里要记住两件事：C.GoString 读取的是指针指向的 C 文本，而不是把 C 指针直接塞进 Go 字符串；C.free 释放的是 C 侧分配的原始地址。即使 Go 侧已经拿到 name，也不能因此省略释放。

没有可靠结尾时改用 C.GoStringN

有些 C API 返回的是“指针 + 长度”，数据可能不是 NUL 结尾，甚至允许正文包含 NUL。此时用 C.GoString 会把第一个 NUL 当成结束；应使用 C.GoStringN(ptr, length)，并把长度限制在 C 接口承诺的有效范围内。

// ptr 指向 C 接口返回的可读缓冲区，length 来自同一个接口的长度字段。
func readBuffer(ptr *C.char, length C.int) (string, error) {
    if ptr == nil {
        return "", fmt.Errorf("nil C string pointer") // 先拒绝空地址
    }
    if length 

C.GoStringN 并不会替你证明长度正确。如果 length 超出可读内存，仍然可能触发越界读取；如果长度比真实文本短，结果会被截断。长度字段必须和指针来自同一份稳定的 C 数据契约。

C.CString 的方向相反也要记得释放

很多问题其实不是“C 字符串怎么读”，而是 Go 把文本传给 C 后忘了回收。C.CString 会在 C 堆中分配带 NUL 结尾的副本，返回的指针不受 Go 垃圾回收器管理。短生命周期调用可以紧跟一个 defer C.free(unsafe.Pointer(ptr))；如果 C 端会异步保存指针，就不能简单地在函数返回前释放，而应改用复制、句柄或明确的生命周期协议。

排查 cgo 字符串问题时看这张清单

• 出现截断：先确认文本中是否有提前出现的 NUL，再检查是否应该使用 C.GoStringN。
• 出现乱码：确认指针仍然有效，编码约定一致，并且没有把释放后的地址继续传给 Go。
• 内存持续上涨：搜索所有 C.CString、malloc 返回值，逐一对应释放路径。
• 读取崩溃：检查长度是否来自同一缓冲区，不能把字符串长度、容量或业务字段误当成可读字节数。

关于 cgo 字符串的两个常见疑问

问：C.GoString 会修改 C 内存吗？答：把它当作读取并生成 Go 字符串副本使用，不要依赖它修改原始缓冲区；需要修改 C 缓冲区时，应在 C 侧按可写缓冲区协议处理。

问：只要调用 C.GoString，就不用释放原指针了吗？答：不是。转换结果和原始指针是两份不同的资源，是否释放取决于指针的来源和 C API 的所有权约定。

最终可以用一句话记忆：有 NUL 结尾用 C.GoString，有可靠长度用 C.GoStringN，Go 传 C 用 C.CString，谁在 C 堆里分配，谁就必须安排对应的释放。