如何在Go中通过cgo将[]string传递到C的char参数

在Go和C的跨语言调用场景中，将Go的[]string传递到C的char*参数是非常常见的需求，由于两者的内存管理机制和类型定义存在本质差异，直接传递会导致程序崩溃或者数据错误，需要按照规范完成类型转换。

cgo基础与环境准备

要使用cgo，首先需要在Go文件中导入"C"包，并且在使用该包之前添加C语言的代码注释，cgo会自动将注释中的C代码和Go代码进行关联编译。需要注意的是，"C"包的导入必须紧邻C代码注释，中间不能插入其他代码。

下面是一个最简单的cgo示例，验证环境是否可用：

package main

// #include <stdio.h>
// void hello() {
//     printf("hello from cn");
// }
import "C"
import "fmt"

func main() {
    C.hello()
    fmt.Println("hello from go")
}

Go字符串与C字符串的差异

在转换之前需要先明确两者的核心区别：

• Go的string是只读的、不可变的，底层结构是包含指向字节数组的指针和长度的结构体，字符串不以空字符结尾。
• C的char*指向的是一个以空字符结尾的字节数组，是可变的，没有内置的长度字段，依赖结尾的空字符判断字符串结束。
• Go的[]string是字符串切片，底层是一个动态数组，存储的是多个string结构，和C的字符串数组char**结构完全不同。

[]string到C char参数的转换步骤

如果C函数的参数是单个char*，我们需要从[]string中取出对应的元素进行转换；如果C函数的参数是char**（字符串数组），则需要将整个切片转换为C的字符串数组。下面分两种场景讲解。

场景1：传递单个字符串到char*参数

假设C函数接收一个char*参数，我们需要从[]string中取第一个元素传递，步骤如下：

1. 使用C.CString()函数将Go的string转换为C的char*，该函数会在C的内存空间分配一块区域，复制字符串内容并添加空字符结尾。
2. 使用完成后必须调用C.free()释放C分配的内存，避免内存泄漏，需要导入"unsafe"包配合操作。

完整代码示例：

package main

// #include <stdio.h>
// #include <stdlib.h>
// void print_c_str(char* s) {
//     printf("c received: %sn", s);
// }
import "C"
import (
    "fmt"
    "unsafe"
)

func main() {
    goStrs := []string{"hello", "world", "cgo"}
    // 取切片第一个元素转换
    cStr := C.CString(goStrs[0])
    // 延迟释放C分配的内存
    defer C.free(unsafe.Pointer(cStr))
    // 调用C函数
    C.print_c_str(cStr)
    fmt.Println("go str:", goStrs[0])
}

场景2：传递整个[]string到char**参数

如果C函数接收char**类型的字符串数组，需要先将每个Go字符串转换为C字符串，再组装成C的字符串数组，步骤如下：

1. 创建一个长度为len(goStrs)的C字符串数组，类型为**C.char。
2. 遍历[]string，将每个元素用C.CString()转换后存入数组。
3. 使用完成后遍历数组释放每个C字符串的内存，再释放数组本身的内存。

完整代码示例：

package main

// #include <stdio.h>
// #include <stdlib.h>
// void print_c_strs(char** strs, int len) {
//     for (int i = 0; i < len; i++) {
//         printf("c received [%d]: %sn", i, strs[i]);
//     }
// }
import "C"
import (
    "fmt"
    "unsafe"
)

func main() {
    goStrs := []string{"hello", "world", "cgo"}
    // 创建C字符串数组
    cStrs := make([]*C.char, len(goStrs))
    // 遍历转换每个字符串
    for i, s := range goStrs {
        cStrs[i] = C.CString(s)
    }
    // 延迟释放每个C字符串的内存
    defer func() {
        for _, s := range cStrs {
            C.free(unsafe.Pointer(s))
        }
    }()
    // 调用C函数，传递数组指针和长度
    C.print_c_strs(&cStrs[0], C.int(len(goStrs)))
    fmt.Println("go strs:", goStrs)
}

常见错误与注意事项

• 忘记释放C.CString()分配的内存，会导致内存泄漏，必须搭配C.free()使用，且释放时要将指针转换为unsafe.Pointer类型。
• 直接传递Go字符串的底层指针到C，Go的字符串是只读的，且C无法识别非空的结尾，会导致未定义行为。
• 转换[]string到char**时，不要直接取Go切片的底层指针传递，Go的内存会被GC回收，C访问时会出现悬空指针。
• 如果C函数会修改传入的字符串内容，需要提前在C侧分配足够的内存，或者使用C.malloc()分配可写的内存空间。

总结

通过cgo传递[]string到C的char参数，核心是理解两者的类型差异，使用C.CString()完成单个字符串的转换，对于字符串数组则需要逐个转换后组装成C的字符串数组，同时严格做好内存的分配和释放，就可以避免大部分跨语言字符串传递的问题。

cgoGo[]stringC_char跨语言调用修改时间：2026-07-13 22:36:33