如何在Go包间共享C代码？遇x86_64未定义符号链接错误求助

你遇到的链接错误核心原因是每个Go包的cgo编译单元完全独立：module1里虽然引入了module2的头文件，但并没有链接到module2.c编译生成的目标文件，所以链接器找不到_module2_c_func符号。下面给你几种可行的解决方案：

方案一：通过静态库共享C代码（传统稳妥方案） #

把共享的C代码编译成静态库，让需要使用的Go包链接这个库，保证符号只编译一次：

1. 编译module2的C代码为静态库
   在module2目录下执行以下命令：

# 先编译成目标文件
gcc -c module2.c -o module2.o
# 打包成静态库
ar rcs libmodule2.a module2.o

2. 修改module1/module1.go的cgo指令
   添加链接静态库的参数，让module1的cgo能找到符号：

package module1

/*
#cgo CFLAGS: -g -Wall -I../module2  // 指定头文件所在路径
#cgo LDFLAGS: -L../module2 -lmodule2  // 指定静态库路径和库名
#include "module2.h"
*/
import "C"

func Module1_invoke_c_func() int {
    return int(C.module2_c_func())
}

这样编译时，module1的cgo会链接libmodule2.a，就能正确找到module2_c_func符号了。

方案二：将共享C代码封装到独立Go包（Go官方推荐） #

通过Go层间接共享C代码，避免跨包直接操作C代码的麻烦。把共享的C代码放到单独的Go包中，其他包通过调用这个包的Go函数来使用C代码：

1. 创建common包目录，结构如下：

cgo_sample/
├── common/
│   ├── common.go
│   ├── common.h
│   └── common.c
├── main.go
├── module1/
│   └── module1.go
└── module2/
    └── module2.go

2. 编写common包代码
   common/common.h：

#ifndef _COMMON_H_
#define _COMMON_H_
int module2_c_func();
#endif

common/common.c：

#include "common.h"
int module2_c_func() {
    return 12;
}

common/common.go：

package common

/*
#cgo CFLAGS: -g -Wall
#include "common.h"
*/
import "C"

// 暴露Go函数给其他包调用
func InvokeModule2CFunc() int {
    return int(C.module2_c_func())
}

3. 修改module1和module2的代码
   module1/module1.go：

package module1

import "cgo_sample/common"

func Module1_invoke_c_func() int {
    return common.InvokeModule2CFunc()
}

module2/module2.go：

package module2

import "cgo_sample/common"

func Module2_invoke_c_func() int {
    return common.InvokeModule2CFunc()
}

这种方法的优势是：C代码只在common包中编译一次，避免了重复编译和链接冲突，同时其他Go包不需要直接处理cgo相关逻辑，代码更简洁易维护。

方案三：直接在引用包中包含C源文件（临时测试用） #

如果你只是快速验证功能，可以在module1的cgo注释中直接包含module2.c，但这会导致C代码被编译两次（module1和module2各编译一次），可能引发重复符号错误，只适合临时场景：

package module1

/*
#cgo CFLAGS: -g -Wall -I../module2
#include "module2.h"
#include "../module2/module2.c"  // 直接包含C源文件
*/
import "C"

func Module1_invoke_c_func() int {
    return int(C.module2_c_func())
}

内容的提问来源于stack exchange，提问作者Damian S.