导入cv2报错（共享对象依赖缺失），求助Linux环境下解决办法

我来帮你搞定这个问题，核心是动态链接库路径未被系统识别，加上多Python版本导致cv2.so分散的情况，咱们一步步解决：

第一步：定位缺失的库文件 #

首先得找到libopencv_hdf.so.3.4到底在哪个目录里，打开终端执行：

find /usr/local /usr -name "libopencv_hdf.so.3.4"

通常这个文件会在你编译OpenCV时指定的安装目录下的lib文件夹里，比如/usr/local/lib或者你自定义的~/opencv-build/lib这类路径。

第二步：让系统识别动态链接库 #

找到路径后，要让Linux系统能找到这个库，有两种方式：

临时生效（仅当前终端会话） #

直接在终端执行：

export LD_LIBRARY_PATH=/path/to/your/opencv/lib:$LD_LIBRARY_PATH

把/path/to/your/opencv/lib替换成你刚才找到的实际路径，然后启动Python3试试import cv2，如果成功了，再做永久配置。

永久生效（全局有效） #

这种方式比修改~/.bashrc更可靠，因为LD_LIBRARY_PATH在非交互式shell或者sudo环境下可能不生效：

1. 创建一个opencv的配置文件：

   sudo touch /etc/ld.so.conf.d/opencv.conf
   

2. 用编辑器打开这个文件，把刚才找到的库路径写进去，比如：

   /usr/local/lib
   

3. 更新系统的动态链接库缓存：

   sudo ldconfig
   

完成后重启终端，再试import cv2。

第三步：清理多Python版本的cv2.so（可选但推荐） #

你提到每个Python版本目录下都有cv2.so，这是因为编译OpenCV时没有明确指定Python3的路径，导致它默认安装到了所有检测到的Python环境里。如果想彻底解决这个问题，可以重新编译OpenCV，指定Python3的路径：

1. 进入OpenCV的build目录（如果之前有build的话，先清空：rm -rf *）
2. 执行cmake命令，明确指定Python3的相关路径：

   cmake -D CMAKE_BUILD_TYPE=RELEASE \
         -D CMAKE_INSTALL_PREFIX=/usr/local \
         -D PYTHON3_EXECUTABLE=$(which python3) \
         -D PYTHON3_INCLUDE_DIR=$(python3 -c "from distutils.sysconfig import get_python_inc; print(get_python_inc())") \
         -D PYTHON3_PACKAGES_PATH=$(python3 -c "from distutils.sysconfig import get_python_lib; print(get_python_lib())") \
         -D INSTALL_PYTHON_EXAMPLES=ON \
         -D INSTALL_C_EXAMPLES=OFF \
         -D OPENCV_ENABLE_NONFREE=ON \
         -D BUILD_EXAMPLES=ON ..
   

3. 编译安装：

   make -j$(nproc)
   sudo make install
   

这样编译完成后，cv2.so只会出现在你指定的Python3的site-packages目录下，不会再乱跑到其他Python版本里。

最后验证 #

重启终端后，打开Python3，执行：

import cv2
print(cv2.__version__)

如果能正常输出版本号，就说明问题解决了。

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