OpenCV调用提示缺失numpy，pip却显示已安装的问题求助

问题场景 #

运行基于OpenCV的摄像头代码时触发以下报错：

OpenCV bindings requires "numpy" package.
Install it via command:
    pip install numpy
Traceback (most recent call last):
  File "/home/pi/Documents/security-camera/take_picture.py", line 1, in <module>
    import cv2
  File "/home/pi/.local/lib/python3.9/site-packages/cv2/__init__.py", line 12, in <module>
    import numpy.core.multiarray
ModuleNotFoundError: No module named 'numpy.core.multiarray'

但执行python3 -m pip install numpy时，系统提示numpy已安装：

pi@raspberrypi:~/Documents/security-camera $ python3 -m pip install numpy
Looking in indexes: https://pypi.org/simple, https://www.piwheels.org/simple
Requirement already satisfied: numpy in /usr/lib/python3/dist-packages (1.19.5)

解决方法 #

1. 强制重新安装numpy到当前Python环境 #

问题核心是OpenCV所在的用户本地环境（.local目录）找不到系统目录下的numpy，执行以下命令强制将numpy安装到当前Python环境的site-packages：

python3 -m pip install numpy --upgrade --force-reinstall

2. 修复损坏的numpy安装 #

如果numpy文件损坏导致无法加载核心模块，先卸载再重新安装（优先用树莓派优化的piwheels源）：

# 卸载现有numpy
python3 -m pip uninstall numpy -y
# 从piwheels重新安装
python3 -m pip install numpy --index-url https://www.piwheels.org/simple

3. 建立软链接匹配路径 #

将系统目录下的numpy链接到OpenCV所在的用户本地环境：

# 先删除本地可能存在的损坏numpy文件
rm -rf /home/pi/.local/lib/python3.9/site-packages/numpy*
# 建立软链接
ln -s /usr/lib/python3/dist-packages/numpy /home/pi/.local/lib/python3.9/site-packages/numpy

4. 使用虚拟环境隔离依赖 #

如果全局环境依赖混乱，创建独立虚拟环境管理依赖：

# 创建虚拟环境
python3 -m venv camera-env
# 激活虚拟环境
source camera-env/bin/activate
# 安装所需依赖
pip install numpy opencv-python

激活环境后再运行代码，即可确保依赖版本匹配。

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