Ubuntu下通过CMake安装OpenCV后Python无法找到cv2模块求助

1. 检查CMake编译时的Python相关参数 #

确认编译OpenCV时是否开启Python绑定支持，查看你的CMake参数是否包含以下关键项：

• BUILD_opencv_python3=ON
• PYTHON3_EXECUTABLE：指向你的Python3可执行文件路径（例如/usr/bin/python3.8）
• PYTHON3_INCLUDE_DIR：Python3的头文件路径（例如/usr/include/python3.8）
• PYTHON3_LIBRARY：Python3的库文件路径（例如/usr/lib/x86_64-linux-gnu/libpython3.8.so）
• PYTHON3_NUMPY_INCLUDE_DIRS：NumPy的头文件路径（若需支持NumPy）

若这些参数未正确设置，CMake不会生成Python的cv2模块，需重新运行CMake并指定正确参数。

2. 定位编译生成的cv2模块 #

编译完成后，OpenCV会生成类似cv2.cpython-xxm-x86_64-linux-gnu.so的文件（xx对应Python版本，如38对应3.8），通常位于：

• OpenCV-build/lib/python3.x/site-packages/
• OpenCV-build/lib/python3/dist-packages/

找到该文件后，确认它是否被安装到Python的site-packages目录下。

3. 手动安装cv2模块到Python环境 #

若编译生成了cv2模块但未自动安装，可手动复制：

1. 找到编译生成的cv2相关文件（如cv2.cpython-38-x86_64-linux-gnu.so及对应的cv2文件夹）
2. 复制到目标Python环境的site-packages目录，示例命令：

   sudo cp -r /path/to/opencv-build/lib/python3.8/site-packages/cv2 /usr/lib/python3/dist-packages/
   

   若使用虚拟环境，路径为~/venv/lib/python3.8/site-packages/

4. 配置Python环境变量 #

确保Python能找到cv2模块路径，先查看Python的模块搜索路径：

python3 -c "import sys; print(sys.path)"

若cv2所在目录不在列表中，临时添加路径：

export PYTHONPATH="/path/to/opencv-build/lib/python3.8/site-packages:$PYTHONPATH"

要永久生效，将上述命令添加到~/.bashrc或~/.zshrc文件，然后执行source ~/.bashrc。

5. 验证安装结果 #

执行以下命令测试：

python3 -c "import cv2; print(cv2.__version__)"

若输出4.5.1，说明问题已解决。

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