如何编译OpenCV 4.6.0仅生成独立libopencv_world.so无符号链接？

问题概述 #

• 编译OpenCV 4.6.0的world共享库时，默认生成三类文件：
  • 主库文件libopencv_world.so.4.6.0
  • 符号链接libopencv_world.so（指向主库）
  • 符号链接libopencv_world.so.406（指向主库）
• Qt应用编译阶段依赖libopencv_world.so，但运行阶段会查找libopencv_world.so.406，复制两个文件会产生冗余，希望仅生成独立的libopencv_world.so。
• 当前Qt项目配置：LIBS += -L$$PWD/../Libs/opencv2/precompiled/linux_release/ -lopencv_world
• 已尝试无效方案：
  1. 设置CMAKE_SHARED_LINKER_FLAGS = -fno-version，导致主库未生成，符号链接指向不存在的文件
  2. 将VERSION和SOVERSION设为空字符串，问题依旧

可行解决方案 #

方案1：修改OpenCV CMake核心配置 #

在CMake配置阶段（cmake-gui或命令行）添加以下配置，强制生成无版本号的共享库：

# 强制共享库后缀为.so，不带版本号
SET(CMAKE_SHARED_LIBRARY_SUFFIX ".so")

# 针对opencv_world目标清除版本属性
SET_TARGET_PROPERTIES(opencv_world PROPERTIES
    VERSION ""
    SOVERSION ""
    NO_SONAME ON
)

• NO_SONAME ON会让链接器不为库添加SONAME字段，避免运行时查找带版本号的库文件
• 若使用cmake-gui，可在"Advanced"模式下找到opencv_world的目标属性，手动设置上述参数

方案2：编译后手动调整（临时 workaround） #

如果修改CMake配置仍有问题，可在编译完成后执行以下操作：

1. 删除自动生成的符号链接libopencv_world.so和libopencv_world.so.406
2. 将主库文件libopencv_world.so.4.6.0重命名为libopencv_world.so
3. 保持Qt项目的LIBS配置不变，运行时系统会直接加载重命名后的库

方案3：调整Qt运行时库查找逻辑 #

在Qt项目的.pro文件中添加以下配置，让运行时优先查找无版本号的库：

# 添加库路径到运行时搜索目录
QMAKE_RPATHDIR += $$PWD/../Libs/opencv2/precompiled/linux_release/
QMAKE_LFLAGS += -Wl,-rpath,'$$ORIGIN/../Libs/opencv2/precompiled/linux_release/'

这样运行时会直接从指定路径加载libopencv_world.so，而非查找带版本号的文件

验证步骤 #

1. 重新编译OpenCV world库，检查输出目录是否仅存在libopencv_world.so
2. 编译Qt应用，确认链接过程无报错
3. 运行Qt应用，验证库加载正常，无缺失依赖的错误

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