如何在编译阶段为动态库统一设置rpath？

问题背景 #

我在为Perl CommonMark模块添加全平台、多Perl版本及多cmark版本测试时，卡在了自定义位置编译的cmark库运行时查找问题上：

• macOS下，设置INC=-"I/cmark-$version/include" LIBS=-"L/cmark-$version/lib -lcmark"能完成编译，但部分Perl版本运行时找不到cmark库
• 用install_name_tool -add_rpath可以解决，但重复添加会报错，只能加|| true绕过
• 尝试OTHERLDFLAGS=-Wl,-rpath,/cmark-$version/lib无效，且不同Perl/ExtUtils::MakeMaker版本自动添加rpath的行为不一致

跨平台通用解决方案 #

1. 利用LD_RUN_PATH环境变量（推荐跨平台） #

LD_RUN_PATH是类Unix系统（含macOS）的标准环境变量，编译时设置它会让链接器自动把指定路径加入动态库的rpath；Windows下Perl的编译链也会识别类似逻辑：

export LD_RUN_PATH="/cmark-$version/lib"
perl Makefile.PL INC="-I/cmark-$version/include" LIBS="-L/cmark-$version/lib -lcmark"
make
make install

• 类Unix系统：链接器会自动将LD_RUN_PATH的路径写入动态库的rpath，无需后续手动修改
• Windows：Perl的ExtUtils::MakeMaker会将该路径转化为对应的运行时库搜索路径配置，确保DLL能被找到

2. 直接配置ExtUtils::MakeMaker的LDDLFLAGS #

如果LD_RUN_PATH不满足需求，可以直接修改LDDLFLAGS——这是MakeMaker用于链接动态扩展的核心参数，跨平台兼容：
在Makefile.PL中添加或修改配置：

use ExtUtils::MakeMaker;

WriteMakefile(
    # 保留原有其他配置
    LDDLFLAGS => "-Wl,-rpath,/cmark-$version/lib " . $ExtUtils::MakeMaker::LDDLFLAGS,
    INC       => "-I/cmark-$version/include",
    LIBS      => ["-L/cmark-$version/lib -lcmark"],
);

• macOS/Linux：-Wl,-rpath,/path/to/lib会被链接器识别，添加永久rpath
• Windows：MakeMaker会自动将该参数转化为适合MSVC或MinGW的链接选项，确保DLL路径被正确设置

3. 优化install_name_tool避免重复添加rpath #

如果必须保留install_name_tool的方式，可以先检查rpath是否已存在再执行添加，避免报错：

if [[ "${OSTYPE}" == "darwin"* ]]; then
    RPATH_TO_ADD="${PREFIX}/lib"
    # 检查bundle中是否已包含目标rpath
    otool -l blib/arch/auto/CommonMark/CommonMark.bundle | grep -q "path ${RPATH_TO_ADD}"
    if [ $? -ne 0 ]; then
        install_name_tool -add_rpath "${RPATH_TO_ADD}" blib/arch/auto/CommonMark/CommonMark.bundle
    fi
fi

这样就无需加|| true，只有当rpath不存在时才执行添加操作。

关于不同Perl版本rpath行为差异的说明 #

不同版本的ExtUtils::MakeMaker对LIBS中的-L参数处理逻辑不同：

• 较新版本的MakeMaker会自动将-L路径加入rpath（macOS下）
• 旧版本则不会，需要手动指定rpath参数

通过上述LD_RUN_PATH或LDDLFLAGS的方法，可以统一所有版本的行为，确保rpath被正确添加。

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