Python + PyCharm + OpenCV 环境搭建指南
首先了解基本概念:
- Python: 解释器,用于解释执行 .py 代码文件。
- PyCharm: 开发工具,用于编写和运行代码文件。
- OpenCV: 第三方库,提供图像处理的函数。
一、安装 Python 解释器
由于 Python 官网是国外网站,下载速度可能较慢,建议根据操作系统选择对应的安装包进行下载和安装。
Windows 系统 64 位:访问 Python 官网下载 python-3.8.10-amd64.exe(或更新版本)。 Mac 系统:访问 Python 官网下载 python-3.10.1-macos11.pkg(或更新版本)。
下载完成后,双击安装文件按照指引点击下一步完成安装。具体步骤如下:
- 双击安装文件。
- 重要:务必勾选 Add Python 3.8 to PATH,将 Python 命令工具所在目录添加到系统 Path 环境变量中,方便后续开发。
- 继续按提示操作直至安装完成。
二、安装 PyCharm
安装完成后,需要安装编写或修改代码的工具:PyCharm。
PyCharm 是一种 Python 开发工具,提供调试、语法高亮、项目管理、代码跳转、智能提示、自动完成、单元测试、版本控制等功能。推荐安装社区版,因为它是免费的。
下载完成后即可安装,操作步骤如下:
- 双击安装文件,点击 Next。
- 可选择自定义路径安装,或使用默认路径。
- 参考安装向导勾选相关选项(如创建桌面快捷方式等),点击 Next。
- 点击 Install 开始安装。
- 安装完成后点击 Finish。
三、安装 OpenCV
成功安装和配置好开发环境后,接下来创建项目并安装 OpenCV。
- 打开 PyCharm,点击创建新项目。
- 输入项目名称,确定后会自动创建虚拟环境和工程目录,通常包含 main.py 文件。
- 点击 PyCharm 底部工具栏里的 Terminal(终端)按钮。
- 在弹出的窗口中输入
pip list查看已安装的库。
若提示 pip 版本过低,建议升级至最新版本以消除警告。复制以下命令并按回车执行:
python.exe -m pip install --upgrade pip
执行成功后会显示 Successfully。
接下来安装图像处理库 opencv-python。继续在终端输入以下命令:
pip install opencv-python<4.6 -i https://mirror.baidu.com/pypi/simple
使用 -i 参数指定百度镜像源可加快下载速度。安装完成后再次输入 pip list,确认列表中多了 opencv-python 和 numpy 库。
四、验证安装
此时可以在代码文件中编写代码来验证安装是否成功。创建一个简单的测试脚本:
import cv2
print(cv2.__version__)
保存文件后,右键点击代码页面选择运行代码文件。如果控制台输出版本号且无报错,则表示 OpenCV 安装成功,可以开始进行图像处理开发。


