在日常的 Go 语言（Golang）开发中，我们绝大多数时候都在享受高效的垃圾回收（GC）和安全的内存管理。但有时为了复用底层成熟的 C/C++ 库（如 OpenCV、FFmpeg、SQLite 等），或者需要直接操作底层硬件，我们就需要借助 Go 提供的标准工具 —— CGO。

什么是 CGO？

CGO 是连接 Go 语言和 C 语言的桥梁。它允许 Go 程序直接调用 C 语言的代码，或者让 C 语言调用 Go 函数。

开启 CGO 的核心标志是在 Go 代码中引入一个虚拟的包：import "C"。

基础篇：CGO 的 “Hello World”

我们先从最简单的无参数调用开始。在 Go 文件中，写在 import "C" 紧上方注释里的 C 代码，会被 CGO 编译器正确解析。

代码实现

新建一个 main.go 文件：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
package main

/*
#include <stdio.h>

// 这是一个纯 C 语言函数
void sayHello() {
    printf("Hello from C!\n");
}
*/
import "C" // ⚠️ 注意：这一行必须紧跟在上面的 C 代码注释下方，绝对不能有空行！

func main() {
    // 通过虚拟包 C 直接调用 C 函数
    C.sayHello()
}

⚡ 核心避坑点

注释与 import "C" 之间绝对不能有空行！
如果你写成了下面这样：

1
2
3
4
5
6
/*
#include <stdio.h>
void sayHello() { ... }
*/

import "C" // 错误！多了一个空行

编译时就会直接报错：could not determine what C.sayHello refers to。这是 CGO 初学者最常踩的第一个坑。

进阶篇：跨语言参数传递与内存管理

当我们需要向 C 函数传递参数时，事情就变得稍微复杂了一点。因为 Go 语言有垃圾回收机制（GC），而 C 语言没有。

特别是传递字符串时，Go 的字符串（带长度、只读）和 C 的字符串（以 \0 结尾的字节数组）在底层完全不同。我们需要使用 C.CString 进行显式转换，并手动释放内存。

代码实现

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
package main

/*
#include <stdio.h>
#include <stdlib.h> // ⚠️ 使用 free() 函数必须引入这个头文件

// 修改后的 C 函数：接收一个字符串指针和一个整型参数
void sayHello(const char* name, int age) {
    printf("Hello %s from C! You are %d years old.\n", name, age);
}
*/
import "C"
import "unsafe" // ⚠️ 转换指针释放内存时需要使用

func main() {
	goName := "Alice"
	goAge := 25

	// 1. 将 Go 字符串转换为 C 字符串（会在 C 的堆区分配内存）
	cName := C.CString(goName)

	// 2. 必须使用 defer 释放 C 字符串内存，否则会导致内存泄漏！
	// ⚠️ 传递 cName 变量本身即可，千万不要传 &cName
	defer C.free(unsafe.Pointer(cName))

	// 3. 将 Go 的 int 显式强转为 C 的 int
	cAge := C.int(goAge)

	// 4. 调用 C 函数并传参
	C.sayHello(cName, cAge)
}

🛠️ 参数传递三剑客

  1. C.CString()：将 Go 字符串拷贝到 C 内存中。用完必须配对使用 C.free()。
  2. unsafe.Pointer()：由于 C.free 接收的是通用指针，我们需要通过 unsafe 包将 C 字符串指针转换为通用指针。
  3. 类型强转：Go 的原生类型（如 int, float64）不能直接传给 C，必须通过 C.int(), C.double() 等方法做显式转换。

环境准备与编译运行

要运行上面的 CGO 代码，你的电脑上必须具备 C 语言编译器（GCC 或 Clang）。

1. 检查 C 编译器

在终端执行：

1
gcc --version
  • Windows：推荐安装 msys2 或 Mingw-w64。
  • macOS：终端运行 xcode-select --install 即可。
  • Linux：使用自带包管理器（如 Ubuntu 运行 sudo apt install build-essential）。

2. 检查 CGO 开关

1
go env CGO_ENABLED

确保输出为 1。如果是 0，请在环境里将其设置为 1（例如 Linux/Mac 下执行 export CGO_ENABLED=1）。

3. 运行代码

在代码目录下执行：

1
go run .

🎨 VS Code 飘红？教你配置专属 Language Server

如果在编辑 CGO 代码时，VS Code 的 Go 插件报出一堆 undefined: C.xxx 的红色波浪线，不要惊慌，这是因为语言服务器（gopls）默认没有开启 CGO 识别。

解决办法：

  1. 按下快捷键 Ctrl + ,（Mac 为 Cmd + ,）打开设置。
  2. 搜索 go.gopls，点击 **”在 settings.json 中编辑”**。
  3. 在配置项中加入以下环境变量支持：
    1
    2
    3
    4
    5
    "gopls": {
        "build.env": {
            "CGO_ENABLED": "1"
        }
    }
  4. 保存后，按下 Ctrl + Shift + P，输入并执行 Go: Restart Language Server 重启插件，飘红即可完美消除！

总结

CGO 赋予了 Go 语言无限的扩展能力，让我们能直接站在 C/C++ 巨人的肩膀上。但硬币都有两面，跨语言调用会带来额外的性能开销（由于栈切换和内存拷贝），同时也会让代码丧失部分内存安全性。因此在实际项目中，建议只在核心、必须的底层库对接时使用 CGO，其余场景尽量保持纯 Go 代码的纯洁性。