基于Pi GPIO库生成libpigpio.so后出现无厘头GCC链接错误

嘿，我之前折腾Pi GPIO库的时候也碰到过一模一样的链接问题，咱们一步步拆解排查，大概率能解决：

最常见的原因：编译时未指定链接pigpio库 #

GCC不会自动识别你本地编译的libpigpio.so，必须显式告诉它要链接这个库，而且库参数的位置很重要——要放在源文件之后：

• 如果你的库在当前工作目录，编译命令应该是：

  gcc your_main.c -o your_program -L. -lpigpio
  

  其中：
  • -L.：告诉GCC在当前目录（.）搜索库文件
  • -lpigpio：指定链接libpigpio.so（GCC会自动把lib前缀和.so后缀补上）

验证库文件是否包含目标函数 #

有时候可能编译库的过程看起来正常，但实际函数没被正确打包进共享对象里。你可以用nm命令检查：

nm -D libpigpio.so | grep -E "gpioInitialise|gpioGetPWMfrequency"

如果输出里能看到类似下面的内容（T代表函数在文本段，即已定义），说明库没问题：

0000000000004210 T gpioInitialise
0000000000005f20 T gpioGetPWMfrequency

如果看不到这些符号，那得回头检查Makefile的编译步骤，确认pigpio.o和command.o确实包含这些函数，再重新编译库。

确保头文件与库的版本一致 #

如果你编译程序时用的pigpio.h和编译libpigpio.so时用的不是同一个版本，可能会出现函数声明和库中实际定义不匹配的情况，导致链接错误。务必保证两者是同一套源码里的文件。

运行时库路径补充（可选） #

如果编译成功但运行时提示找不到库，你需要指定共享库的搜索路径：

LD_LIBRARY_PATH=. ./your_program

或者把libpigpio.so复制到系统默认库路径（比如/usr/local/lib），然后运行sudo ldconfig更新缓存。

举个完整的例子：假设你的主程序是test_gpio.c：

#include <stdio.h>
#include "pigpio.h"

int main() {
    int init_status = gpioInitialise();
    if (init_status < 0) {
        fprintf(stderr, "GPIO初始化失败，错误码：%d\n", init_status);
        return 1;
    }

    int pwm_freq = gpioGetPWMfrequency(18);
    printf("GPIO18的PWM频率：%d Hz\n", pwm_freq);

    gpioTerminate();
    return 0;
}

编译命令就是：

gcc test_gpio.c -o test_gpio -L. -lpigpio

内容的提问来源于stack exchange，提问作者Sam Hammamy