Ubuntu环境下Python程序无法访问site-packages模块的求助

Hey there! I’ve seen this exact issue pop up all the time for new Python/Ubuntu users—let’s get your cv2 module working smoothly from your home directory.

First, Let’s Pinpoint the Root Issue #

The most common culprit here is a Python version mismatch: the Python you’re using to run your script isn’t the same one where you installed OpenCV. Ubuntu often comes with multiple Python versions (like Python 2.7 and Python 3.x) or different 3.x releases, and pip installs packages to a specific version’s site-packages folder.

Step 1: Verify Your Python Environments #

Let’s check which Python you’re running vs. where OpenCV lives:

• Run this to see which Python your terminal uses by default:

  which python
  # Or for Python 3 specifically:
  which python3
  

• Next, check the directories your Python searches for modules in:

  python -c "import sys; print('\n'.join(sys.path))"
  # Or for Python 3:
  python3 -c "import sys; print('\n'.join(sys.path))"
  

Compare the output to the path of your site-packages folder where cv2 is stored. If that path isn’t in the list, you’re using the wrong Python version.

Step 2: Fix the Version Mismatch #

If you confirmed a version mismatch, try these fixes:

• If you installed OpenCV with pip3 (for Python 3), run your script with python3 instead of python:

  python3 demo.py
  

• If you installed OpenCV for a specific Python version (like 3.10), use that version’s executable directly:

  python3.10 demo.py
  

• Alternatively, reinstall OpenCV for the Python version you’re using:

  # For Python 3
  pip3 install opencv-python
  # For a specific version
  python3.10 -m pip install opencv-python
  

Step 3: Check for Virtual Environments #

If you’ve ever used a virtual environment (like venv or conda), that could be blocking access to your global OpenCV installation. Virtual environments isolate their own packages—so if your terminal is using a virtual environment, it won’t see globally installed modules.

• Fix options:
  1. Deactivate the virtual environment if it’s active:

     deactivate
     

  2. Or install OpenCV inside the virtual environment (after activating it):

     source your_venv/bin/activate
     pip install opencv-python
     

Step 4: Temporary Workaround (If All Else Fails) #

If you need a quick fix, manually add your site-packages path to your script. Add these lines at the top of demo.py:

import sys
# Replace this path with your actual site-packages directory
sys.path.append('/usr/local/lib/python3.8/site-packages')
import cv2

This tells Python exactly where to find cv2, but it’s better to resolve the environment mismatch long-term.

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