VS2019 CMake远程Linux构建指定Qt版本运行链接错误如何修复？

问题根源 #

你在CMAKE_PREFIX_PATH里配置的路径仅作用于CMake配置编译阶段的库查找，Linux系统动态链接器运行时默认不会搜索该路径，因此会优先加载系统默认路径下的Qt库，导致符号不匹配。

解决方案 #

方案1：在构建配置中嵌入RPATH（推荐） #

直接修改CMakeSettings.json，在cmakeCommandArgs字段添加RPATH相关编译参数，将Qt库路径直接写入可执行文件的运行时搜索路径：

"cmakeCommandArgs": "-DCMAKE_INSTALL_RPATH=\"/opt/Qt5.12.7/5.12.7/gcc_64/lib\" -DCMAKE_BUILD_WITH_INSTALL_RPATH=ON",

修改后清空原有构建缓存，重新执行CMake生成、编译操作即可。编译完成后可执行文件运行时会自动搜索指定的Qt库路径，无需额外配置。

方案2：运行时临时指定库搜索路径 #

如果不想修改构建配置，可在运行程序前临时设置LD_LIBRARY_PATH环境变量：

LD_LIBRARY_PATH=/opt/Qt5.12.7/5.12.7/gcc_64/lib ./program

也可以将上述命令写入启动脚本，避免每次手动输入。

方案3：全局配置动态链接库搜索路径（不推荐） #

如果需要该Qt版本对所有用户生效，可修改系统动态链接配置：

1. 新建配置文件 /etc/ld.so.conf.d/qt5.12.7.conf，写入内容：

/opt/Qt5.12.7/5.12.7/gcc_64/lib

2. 执行命令更新缓存：

sudo ldconfig

该方案会全局修改动态链接库搜索优先级，可能导致依赖系统默认Qt的程序出现兼容性问题，仅建议在专用开发设备上使用。

验证方式 #

修改配置重新编译后，执行ldd ./program查看Qt库的链接路径，确认指向/opt/Qt5.12.7/5.12.7/gcc_64/lib目录下的库文件即可。

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