Go 语言中的 //export：怎样把 Go 函数交给 C 调用

竹里

发布时间：2026-08-25 | 6人浏览过

原创

前言

在需要把 Go 逻辑接入现有 C 或 C++ 工程时，`//export` 是一条很实用的桥接路径，但不少人第一次接触时，往往只知道它能“导出函数”，却不清楚完整流程和使用边界。本文从语法规则、共享库构建到 C 侧调用依次拆开，并补上内存、类型与平台三个常见判断点，帮助你快速确认它是否适合自己的项目。

在需要把 Go 能力嵌进现有 C 或 C++ 工程时，`//export` 往往是最直接的一种做法。它能把 Go 函数导出成 C 可调用接口，但真正落地时，读者更关心的通常不是“能不能用”，而是“要怎么写、会生成什么、哪些地方最容易踩坑”。本文就按这条路径展开：先讲清规则，再给出最小示例，最后补上调用方式和实际使用时的判断点。

//export 是什么，解决了什么问题

//export 是 Go 里的特殊注释指令，用来把 Go 函数导出为 C 语言函数。加上这条指令后，Go 编译器会在构建共享库时一并生成对应的 C 头文件声明，C 代码就能按普通函数接口去调用它。

这个能力的核心价值在于跨语言复用：你可以把逻辑写在 Go 里，再交给已有的 C 程序、C++ 模块或其他依赖 C ABI 的系统去接入，而不必把同一套逻辑重复实现一遍。

使用前先看清的语法规则

要让 //export 生效，有两个基本前提：

必须在函数声明前写上 //export 函数名
文件中必须导入 C 包，也就是 import "C"

这里有一个容易忽略的细节：// 后面要直接跟 export，写法必须是 //export Add 这种形式。导出名要和后面的 Go 函数名对应，位置也必须紧贴函数声明。

另外，示例通常会把代码放在 package main 中，并保留一个空的 main 函数。这不是为了业务逻辑，而是为了满足共享库构建时的组织方式。

最小可运行示例：把 Go 加法函数导出为共享库

如果你想先确认这套机制是否跑通，最简单的方法就是从一个整数加法函数开始。下面这段代码已经具备导出条件：

用纸张卡片和箭头展示 Go 函数通过 //export 导出为 C 可调用接口的关系图 — **//export 导出链路一图看懂**从 Go 函数到共享库与头文件，//export 的导出链路可以先用一张结构图看清。

// add.go
package main

import "C"

//export Add
func Add(a, b C.int) C.int {
    return a + b
}

func main() {
    // 此处留空，但必须有main函数
}

这段代码里有几个关键信号：

使用了 import "C"
导出函数前写了 //export Add
参数和返回值使用的是 C.int，便于和 C 接口对应
保留了 main 函数，即使函数体为空

保存为 add.go 后，使用下面的命令编译：

go build -buildmode=c-shared -o add.so add.go

这里的重点是 -buildmode=c-shared。它告诉 Go 把当前程序构建为可供 C 调用的动态库。命令执行完成后，会得到两个文件：

add.so：生成的动态库
add.h：自动生成的头文件

对接 C 代码时，这两个产物缺一不可：一个负责运行时链接，一个负责声明函数接口。

C 侧如何调用：头文件、编译与运行结果

Go 侧导出完成后，C 代码的接入方式其实比较直接。核心就是包含自动生成的头文件，然后按 C 函数正常调用：

用便签卡片展示 C 侧调用 Go 共享库时的关键步骤与易错点 — **C 程序接入 Go 共享库的最短路径**C 侧接入并不复杂，但头文件、链接方式和运行结果要放在同一条链路里理解。

// main.c
#include <stdio.h>
#include "add.h"  // 包含自动生成的头文件

int main() {
    int result = Add(5, 3);
    printf("5 + 3 = %dn", result);
    return 0;
}

这段示例说明了两件事：一是 Add 已经作为 C 可见符号暴露出来；二是调用方式对 C 程序员来说没有额外心智负担，包含头文件后就能直接使用。

接着编译并运行 C 程序：