使用Homebrew安装OpenCV3报错“No head is defined for opencv”求助

Hey there, sorry you ran into this frustrating error when setting up OpenCV 3 with Homebrew. Let’s break down what’s causing this and walk through a fix that aligns with how Homebrew packages OpenCV today.

Why This Error Happens #

The No head is defined for opencv error pops up because the older tutorials you referenced use commands that don’t match Homebrew’s current formula structure. Back then, you could target OpenCV 3 directly with brew install opencv --HEAD, but now:

• The main opencv formula defaults to OpenCV 4+
• The legacy OpenCV 3 package is now hosted as a versioned formula (opencv@3), and the --HEAD flag isn’t supported for it anymore

Step-by-Step Fix #

1. Clean up old installations to avoid conflicts
   First, make sure you start with a clean slate by removing any existing OpenCV packages and updating Homebrew:

   brew update
   brew uninstall --force opencv opencv3
   brew cleanup
   

2. Install OpenCV 3 using the versioned formula
   Use the dedicated opencv@3 formula to get the exact version you need:

   brew install opencv@3
   

3. Configure environment variables
   You need to add OpenCV 3’s paths to your shell config so your system (and Python) can find it:

   • For bash users:

     echo 'export PATH="/usr/local/opt/opencv@3/bin:$PATH"' >> ~/.bash_profile
     echo 'export PKG_CONFIG_PATH="/usr/local/opt/opencv@3/lib/pkgconfig"' >> ~/.bash_profile
     source ~/.bash_profile
     

   • For zsh users, replace .bash_profile with .zshrc in the commands above

4. Verify the installation
   Confirm everything worked with these quick checks:

   • Check the OpenCV version via terminal:

     pkg-config --modversion opencv
     

   • Test Python integration:

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

Troubleshooting Python Binding Issues #

If Python still can’t find cv2, you may need to symlink the OpenCV 3 Python bindings to your Python’s site-packages directory. For example, if you’re using Python 3.9:

ln -s /usr/local/opt/opencv@3/lib/python3.9/site-packages/cv2 /Library/Frameworks/Python.framework/Versions/3.9/lib/python3.9/site-packages/cv2

Adjust the version numbers to match your installed Python version.

内容的提问来源于stack exchange，提问作者J.Treutlein