Mac High Sierra系统OpenCV导入错误求助及安装操作记录

Hey there, let's work through this OpenCV import error on your Mac High Sierra together. First, let's recap what you've done so far to spot any potential gaps, then walk through fixes step by step.

What you've completed so far: #

• Installed Xcode command line tools:

  sudo xcode-select --install
  

• Updated your system PATH (note: you wrote >> /.bashrc which targets the root user's config—this should be ~/.bashrc for your personal account):

  export PATH=/usr/local/bin:$PATH >> ~/.bashrc
  source ~/.bashrc
  

• Set up Python versions via Homebrew:

  brew install python python3
  brew link python
  brew link python3
  brew postinstall python3
  

• Installed virtualenv and virtualenvwrapper:

  pip3 install virtualenv virtualenvwrapper
  

• Started configuring virtualenvwrapper (your command was cut off, but the standard setup includes defining your virtual environments directory and sourcing the wrapper script).

Step 1: Fix incomplete virtualenvwrapper configuration #

It looks like your virtualenvwrapper setup wasn't finished, which might be causing environment mismatches. Let's fix that:

1. Open your user bash config file with a text editor:

   nano ~/.bashrc
   

2. Replace any partial virtualenvwrapper lines with these complete ones (and correct the PATH line if you had the root directory typo):

   export PATH=/usr/local/bin:$PATH
   export VIRTUALENVWRAPPER_PYTHON=/usr/local/bin/python3
   export WORKON_HOME=$HOME/.virtualenvs
   source /usr/local/bin/virtualenvwrapper.sh
   

3. Save the file (press Ctrl+O then Enter in nano) and exit (Ctrl+X). Reload your bash config to apply changes:

   source ~/.bashrc
   

4. Create and activate a dedicated virtual environment for your OpenCV project:

   mkvirtualenv cv-project -p python3
   

   You'll see (cv-project) at the start of your terminal prompt when the environment is active.

Step 2: Install OpenCV correctly in your virtual environment #

Now that your environment is properly set up, install OpenCV using one of these reliable methods:

Option A: Pip install (simplest for most projects) #

With your cv-project environment active, run:

pip install opencv-python
# If you need extra modules (like face recognition or feature matching), install this too:
pip install opencv-contrib-python

Option B: Homebrew install (for advanced control) #

If you prefer compiling from source or need specific OpenCV flags, use Homebrew:

1. First, remove any conflicting existing OpenCV installations:

   brew uninstall --force opencv opencv3
   

2. Install OpenCV 4 (compatible with High Sierra):

   brew install opencv
   

3. Link the OpenCV Python bindings to your virtual environment. First find where the bindings are stored:

   find /usr/local/Cellar/opencv -name "cv2.cpython-*.so"
   

   You'll get a path like /usr/local/Cellar/opencv/4.5.5/lib/python3.7/site-packages/cv2 (adjust the version numbers to match your install).
4. Create a symlink to your virtual environment's site-packages:

   ln -s /usr/local/Cellar/opencv/4.5.5/lib/python3.7/site-packages/cv2 ~/.virtualenvs/cv-project/lib/python3.7/site-packages/
   

Step 3: Verify the installation #

With your virtual environment active, test importing OpenCV:

python
>>> import cv2
>>> print(cv2.__version__)

If this prints the version number without errors, you're all set!

Troubleshooting remaining issues #

If you still get an import error:

• Double-check you're in the right virtual environment (look for (cv-project) in your terminal prompt—if not, run workon cv-project).
• Make sure you didn't install OpenCV outside the virtual environment by mistake.
• Update Homebrew and fix any system issues:

  brew update
  brew upgrade
  brew doctor
  

• If you see a Library not loaded error, run otool -L $(which python3) to check linked libraries, then use brew reinstall on any missing dependencies.

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