anaconda pycharm ModuleNotFoundError: No module named 'cv2'

### 如何在 Anaconda 和 PyCharm 中安装 opencv-python

当遇到 `ModuleNotFoundError: No module named 'cv2'` 错误时，这通常意味着 OpenCV 没有正确安装或环境配置不正确。为了确保能够在 Anaconda 和 PyCharm 中成功使用 `cv2` 模块，可以遵循以下方法来解决问题。

#### 安装 OpenCV-Python 使用 Conda 或 Pip

对于 Anaconda 用户来说，推荐通过 conda 渠道安装 OpenCV：

conda install -c conda-forge opencv

此命令会自动处理依赖关系并安装适合当前平台版本的 OpenCV[^1]。

而对于偏好 pip 的用户，在终端执行如下指令可完成安装：

pip install opencv-python

需要注意的是，如果项目需要用到额外的功能（比如 SIFT, SURF），则应该考虑安装带有 contrib 扩展包的版本：

pip install opencv-contrib-python

这样不仅包含了基础功能还加入了更多高级算法支持[^2]。

#### 配置 PyCharm 识别新安装的库

即使已经完成了上述操作，有时 IDE 可能不会立即更新其索引从而导致无法找到刚添加进去的新模块。此时可以在 PyCharm 设置里手动刷新解释器路径以确认是否已加载最新状态下的 Python 环境变量。

进入 **File -> Settings (Ctrl+Alt+S)** 菜单下选择 **Project Interpreter** 页面查看是否有 `opencv-python` 列表项存在；如果没有，则点击右侧齿轮图标选择 Add... 来指定本地 anaconda/python.exe 文件位置重新关联一次解释器即可[^3]。