如何修改CMakeLists.txt解决动态库绝对路径引发的跨机器运行问题

你的问题根源是编译时链接器将本地动态库的绝对路径硬编码到了可执行文件中，导致其他机器找不到对应路径的库。以下是修改后的CMakeLists.txt及详细说明：

修改后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.24)
project(MyProject)

add_executable(MyProject main.cpp)

# 用目标级链接目录替代全局link_directories，作用域更清晰
target_link_directories(MyProject PRIVATE "libs/mac_arm64")
target_link_libraries(MyProject PRIVATE expat bz2 z geos_c)

# 配置运行时路径（rpath），让可执行文件通过相对路径查找动态库
set_target_properties(MyProject PROPERTIES
    # 构建阶段的rpath，保证本地编译后能正常运行
    BUILD_RPATH "${CMAKE_CURRENT_SOURCE_DIR}/libs/mac_arm64"
    # 发布后的rpath，@loader_path代表可执行文件自身所在目录
    INSTALL_RPATH "@loader_path/libs/mac_arm64"
    # 让构建阶段也使用INSTALL_RPATH的配置，统一本地和发布环境的路径逻辑
    BUILD_WITH_INSTALL_RPATH ON
)

关键修改点说明 #

1. 替换link_directories为target_link_directories
   全局的link_directories会影响所有编译目标，而target_link_directories仅作用于当前可执行文件，避免不必要的路径污染，是CMake推荐的现代写法。

2. 配置运行时路径（rpath）

   • BUILD_RPATH：指定本地构建时，可执行文件查找动态库的路径，保证你在本地机器上编译后能正常运行。
   • INSTALL_RPATH：指定发布后可执行文件的动态库查找路径。@loader_path是macOS特有的变量，代表可执行文件所在的目录，这样只要将可执行文件和libs/mac_arm64目录按对应层级放置，其他机器就能通过相对路径找到动态库。
   • BUILD_WITH_INSTALL_RPATH ON：让本地构建时也使用发布的rpath规则，避免本地和发布环境的路径逻辑不一致。

发布注意事项 #

分享给他人时，需要将可执行文件和libs/mac_arm64目录一起打包，目录结构示例如下：

├── MyProject（可执行文件）
└── libs
    └── mac_arm64
        ├── expat.dylib
        ├── bz2.dylib
        ├── z.dylib
        └── geos_c.dylib

这样对方运行MyProject时，就能自动通过相对路径找到所有依赖的动态库。

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