如何在SWIG的extconf.rb中正确配置库路径及编译链接参数？

你遇到的问题根源在于直接把链接器专属的参数（比如-L、-l、-Wl,-rpath）塞进了CXXFLAGS——mkmf对编译选项和链接选项是分开处理的，CXXFLAGS只用于C++编译阶段，链接阶段的参数需要放到专门的变量或者用mkmf提供的方法来配置。

下面是修正后的extconf.rb代码：

require 'mkmf'

# 运行SWIG生成Ruby绑定的C++代码
system('swig -c++ -ruby example.i') || abort("Failed to run SWIG")

# 配置GR库的头文件路径和库路径
# 第一个参数是库的标识，后面依次是include路径和lib路径
dir_config('gr', '/usr/local/gr/include', '/usr/local/gr/lib')

# 添加链接依赖库：GR和math库
have_library('GR') || abort("GR library not found")
have_library('m') || abort("Math library not found")

# 添加rpath链接器选项，确保运行时能找到GR库
$LDFLAGS += " -Wl,-rpath,/usr/local/gr/lib"

# 生成Makefile
create_makefile('example')

改动细节说明： #

• 用dir_config管理头文件和库路径：这个方法会自动把指定的include路径加入$INCFLAGS（编译时的头文件搜索路径），把lib路径加入$LDFLAGS（链接时的库搜索路径），比手动修改CXXFLAGS更符合mkmf的规范，也不容易出错。
• 用have_library检查并添加链接库：have_library('GR')会自动尝试链接libGR.so（或对应平台的库文件），并把-lGR加入链接选项；have_library('m')同理处理数学库。同时它还会做可用性检查，如果找不到库会直接终止，方便排查问题。
• 把rpath选项放到$LDFLAGS中：-Wl,-rpath是链接器的参数，必须放到$LDFLAGS里才会被链接阶段使用，之前放到CXXFLAGS里会被忽略，因为编译阶段不需要这个参数。

额外验证小技巧： #

运行ruby extconf.rb后，查看生成的Makefile，检查：

• INCFLAGS里是否包含-I/usr/local/gr/include
• LDFLAGS里是否包含-L/usr/local/gr/lib -Wl,-rpath,/usr/local/gr/lib
• LIBS里是否包含-lGR -lm

如果这些都存在，说明配置正确，接下来运行make就能正常编译链接了。

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