实际上是最近遇到了一个 bug，跟以前写的一篇笔记有相关，就整理一下发出来了。 [toc]

背景

编译一个golang的项目时，提示：缺少git_index_add_from_buffer的动态库。

# github.com/libgit2/git2go/v30 /tmp/go-build349513601/b205/_x019.o: In function `_cgo_eec00726eb8d_Cfunc_git_index_add_from_buffer': /tmp/go-build/cgo-gcc-prolog:161: undefined reference to `git_index_add_from_buffer' collect2: error: ld returned 1 exit status Makefile:21: recipe for target 'binary' failed make: *** [binary] Error 2 

项目时依赖了libgit这个库，搜索git_index_add_from_buffer也可以确认函数是来自libgit。

但是我之前因为版本问题，在apt install libgit因为版本不对（最新是 0.08 ）后，看到项目 Makefile 里有编译安装的方法，就跑了一下，升级到1.0.1：

 cd /tmp  rm -fr libgit2-1.0.1.tar.gz libgit2-1.0.1  curl -Lv -O https://github.com/libgit2/libgit2/releases/download/v1.0.1/libgit2-1.0.1.tar.gz  tar xvfz libgit2-1.0.1.tar.gz  mkdir -p libgit2-1.0.1/build  cd libgit2-1.0.1/build  cmake ..  cmake --build .  sudo cp libgit2.pc /usr/lib/pkgconfig/  sudo cp libgit2.so.1.0.1 /usr/lib  sudo ln -s /usr/lib/libgit2.so.1.0.1 /usr/lib/libgit2.so  sudo cp -aR ../include/* /usr/local/include/ 

解决了问题的了，但为何在链接时还提示缺少git_index_add_from_buffer的引用呢。

调查

[email protected]:/#  readelf -s /usr/lib/libgit2.so.1.0  2>&1 | grep git_index_add_from_buffer    782: 000000000006d9c0   426 FUNC    GLOBAL DEFAULT   12 git_index_add_from_buffer   2680: 000000000006d9c0   426 FUNC    GLOBAL DEFAULT   12 git_index_add_from_buffer 

可以看到，动态链接库里确实有这两个符号

[email protected]:/# cat /usr/lib/pkgconfig/libgit2.pc prefix="/home/cloud/go_dir/src/github.com/git2go/dynamic-build/install" libdir="/home/cloud/go_dir/src/github.com/git2go/dynamic-build/install/lib" includedir="/home/cloud/go_dir/src/github.com/git2go/dynamic-build/install/include"  Name: libgit2 Description: The git library, take 2 Version: 1.0.0 Libs: -L${libdir} -lgit2 Libs.private: -lrt -lpthread -lssh2 Requires.private: openssl zlib Cflags: -I${includedir}  

​ pc 文件就是给pkg-config用的 meta 信息。

可以看到，libgit2.pc文件里的 Version 确实是1.0.0。

但是pkg-config里记录的 version 确实0.08

[email protected]:/# pkg-config --modversion libgit2 0.08 

可见，问题的根源就是这个了，在使用 libgit2 时，pkg-config读取了 0.08 的动态链接库，结果没有git_index_add_from_buffer。

pkg-config is a helper tool used when compiling applications and libraries.

It helps you insert the correct compiler options on the command line so an application can use gcc -o test test.cpkg-config –libs –cflags glib-2.0“ for instance, rather than hard-coding values on where to find glib (or other libraries). It is language-agnostic, so it can be used for defining the location of documentation tools, for instance.

必要的背景知识

pkg-config: 是一个软件，跟make一样都是软件。linux 在编译与链接程序时需要用到它来找到必要的动态链接库，例子：

gcc -o test test.c `pkg-config --libs --cflags glib-2.0` 

pkg-config –libs –cflags glib-2.0 就是找到所有的 glib 依赖：

$ pkg-config --libs --cflags glib-2.0 -I/usr/local/Cellar/glib/2.64.3/include/glib-2.0 -I/usr/local/Cellar/glib/2.64.3/lib/glib-2.0/include -I/usr/local/opt/gettext/include -I/usr/local/Cellar/pcre/8.44/include -L/usr/local/Cellar/glib/2.64.3/lib -L/usr/local/opt/gettext/lib -lglib-2.0 -lintl 

结论

接上， 问题根源就是 golang 编译时，去找libgit2的库时，在pkg-config里，读的 pc 文件不是指向0.08动态链接库的版本库。

找一下pkg-config读 pc 文件的规则，就发现pkg-config找 pc 文件，是根据环境变量来找的：

 pkg-config --variable pc_path pkg-config /usr/local/lib/x86_64-linux-gnu/pkgconfig: /usr/local/lib/pkgconfig: /usr/local/share/pkgconfig: /usr/lib/x86_64-linux-gnu/pkgconfig: /usr/lib/pkgconfig:/usr/share/pkgconfig 

然后就是从上往下找libgit2的 pc 文件.

而Makefile 在拷 libgit2 的配置时，拷到了sudo cp libgit2.pc /usr/lib/pkgconfig/ 。

但是刚好，我之前用 apt install 装过，所以在/user/local/lib/pkgconfig里就有了 libgit2 的配置了。。所以一直用了 28 版本的动态链接库，就没这个符号了。

解决方法

• 卸载 apt install 的 libgit2，这样子/user/local/lib/pkgconfig就会被卸载
• 将“sudo cp libgit2.pc /usr/lib/pkgconfig/` 改成拷到优先读目录（不推荐，复写了 apt 安装的版本）