第2章 开发环境搭建

Python 3.x 安装与配置 · pip换源 · 虚拟环境(venv) · 安装 OpenCV-Python 与 NumPy

📦 开发环境搭建流程 Python 3.x pip 换源 venv 虚拟环境 OpenCV + NumPy

1. Python 3.x 安装与配置

访问 python.org 下载 Python 3.8 及以上版本(推荐 3.10 / 3.11)。安装时务必勾选 “Add Python to PATH”。验证安装:

python --version
pip --version
✅ 终端验证示例 $ python --version → Python 3.11.4 $ pip --version → pip 23.2.1

2. pip 换源(国内加速)

使用国内镜像源可大幅提升下载速度。临时使用:

pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple

永久配置(全局):

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
镜像源名称URL
清华大学https://pypi.tuna.tsinghua.edu.cn/simple
阿里云https://mirrors.aliyun.com/pypi/simple/
中国科技大学https://pypi.mirrors.ustc.edu.cn/simple/
📡 pip 换源示意 pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

3. 虚拟环境 (venv) 创建与使用

为项目创建独立环境,避免依赖冲突:

# 创建虚拟环境(在项目目录下)
python -m venv motion_env

# 激活环境 (Windows)
motion_env\Scripts\activate

# 激活环境 (macOS / Linux)
source motion_env/bin/activate

# 退出环境
deactivate
🧪 venv 虚拟环境结构 motion_env Scripts Lib site-packages

4. 安装 OpenCV-Python 与 NumPy

在激活的虚拟环境中执行:

pip install opencv-python numpy

验证安装:

python -c "import cv2; print(cv2.__version__)"
python -c "import numpy; print(numpy.__version__)"
📌 版本参考(2025年稳定)
opencv-python ≥ 4.8.1  ·  numpy ≥ 1.24.0
📦 核心库安装 pip install opencv-python numpy cv2 4.9.0 · numpy 1.26

5. 完整环境检查清单

组件命令 / 检查项预期结果
Pythonpython --version≥ 3.8
pippip --version≥ 21.0
虚拟环境python -m venv test_env目录创建成功
OpenCVpython -c "import cv2"无报错
NumPypython -c "import numpy"无报错