在Go函数中调用c动态库

2023年3月9日 267次阅读 来源: Mark_Zhang

在很多场景下，在Go的程序中需要调用c函数或者是用c编写的库（底层驱动，算法等，不想用Go语言再去造一遍轮子，复用现有的c库）。
那么该如何调用呢？Go可是更好的C语言啊，当然提供了和c语言交互的功能，称为Cgo！
Cgo封装了#cgo伪c文法，参数CFLAGS用来传入编译选项，LDFLAGS来传入链接选项。这个用来调用非c标准的第三方c库。

1）先从最简单的写起吧，Go代码直接调用c函数，下面的示例中在代码注释块调用了标准的c库，并写了一个c函数(本例只是简单打印了一句话，在该注释块中可以写任意合法的c代码)，在Go代码部分直接调用该c函数hi()

package main

import "fmt"

/*
#include <stdio.h>

void hi() {
    printf("hello world!\n");
}
*/
import "C" //这里可看作封装的伪包C, 这条语句要紧挨着上面的注释块，不可在它俩之间间隔空行！

func main() {
    C.hi()
    fmt.Println("Hi, vim-go")
}

运行结果：

root@slave2:/home/cgo# go run main.go 
hello world!
Hi, vim-go

好，我可以在Go代码中写c代码了，那么我该如何在Go中直接调用已经编译好的第三方c库呢？用Cgo！
2）本例示范在Go代码中调用非标准的c的第三方动态库
c文件

/*
 * hi.c
 * created on: July 1, 2017
 *      author: mark
 */

#include <stdio.h>

void hi() {
    printf("Hello Cgo!\n");
}

h文件

void hi();

编译成动态库.so

root@slave2:/home/cgo# gcc -c -fPIC -o hi.o hi.c
root@slave2:/home/cgo# gcc -shared -o libhi.so hi.o

Go文件

package main

import "fmt"

/*
#cgo CFLAGS: -I./
#cgo LDFLAGS: -L./ -lhi
#include "hi.h" //非标准c头文件，所以用引号
*/
import "C"

func main() {
    C.hi()
    fmt.Println("Hi, vim-go")
}

重点来了（敲黑板）：
CFLAGS中的-I（大写的i） 参数表示.h头文件所在的路径
LDFLAGS中的-L(大写) 表示.so文件所在的路径 -l(小写的L) 表示指定该路径下的库名称，比如要使用libhi.so，则只需用-lhi （省略了libhi.so中的lib和.so字符，关于这些字符所代表的具体含义请自行google）表示。
运行结果：

root@slave2:/home/cgo# go run main.go 
Hello Cgo!
Hi, vim-go

更深入一些，
1）头文件路径和库文件路径写死的话，一旦第三方库的安装路径变化了，Golang的代码也要跟着变化，就会很麻烦。这时可以使用cgo命令中使用pk-config，具体请参考这篇博文：Golang使用pkg-config自动获取头文件和链接库的方法
2）当在Go中使用了以上的方法后，就要求主机（或者云服务器）上必须有相应的.so文件，如果不存在就会链接报错，导致程序退出。
若.so是一些不必要的第三方驱动库（可有可无），那就麻烦了，你不能为了跑这个程序，把每台主机都装上那个不必要的第三方库吧。有没有一种方法可以在Go程序运行时才调用这些.so库呢，如果不存在忽略就好（就不启用那个库提供的功能了，而不是链接报错直接异常退出）？当然有！敬请期待一下一篇。:)

    原文作者：Mark_Zhang
    原文地址: https://www.jianshu.com/p/ec51bac42f9c
    本文转自网络文章，转载此文章仅为分享知识，如有侵权，请联系博主进行删除。
点赞