OpenCV3 在 Windows 系统上的完整安装指南

OpenCV（Open Source Computer Vision Library）是一个开源的计算机视觉库，在图像处理、人脸识别、物体检测等领域应用广泛。对于刚接触编程或计算机视觉的新手来说，在Windows上安装OpenCV3可能会遇到一些困难。本文将手把手带你完成整个安装和配置过程，即使你是电脑小白，也能跟着步骤顺利完成。

一、安装前准备工作

在开始安装OpenCV3之前，我们需要做好以下准备，这就像盖房子前要准备好砖瓦和工具一样。

1.1 检查你的Windows系统

首先，确认你的Windows系统是64位还是32位：

右键点击“此电脑”或“我的电脑”
选择“属性”
在“系统类型”处可以看到你的系统位数

建议：大多数现代电脑都是64位系统，本文将以64位系统为例进行讲解。如果你的是32位系统，后续步骤中选择对应的32位版本即可。

1.2 准备安装包

我们需要两个主要软件：

OpenCV3 安装包 - 这是主角
Python - 这是运行OpenCV的编程环境（如果你打算用Python）
CMake 和 Visual Studio - 如果你需要从源代码编译

对于新手，我推荐使用预编译的二进制包，这样最简单。

二、详细安装步骤（Python版）

这是最适合新手的方法，我们使用Python来调用OpenCV。

2.1 安装Python

打开浏览器，访问Python官网
下载Python 3.6或3.7版本（OpenCV3对这些版本支持最好）
运行下载的安装程序
重要：在安装界面，一定要勾选“Add Python to PATH”（将Python添加到系统路径）
点击“Install Now”完成安装

验证安装是否成功：

按 Win + R 键，输入 cmd，按回车打开命令提示符
输入 python --version 并按回车
如果显示Python版本号（如Python 3.7.0），说明安装成功

2.2 安装OpenCV3

现在我们来安装OpenCV3，这里有两种方法：

方法一：使用pip安装（最简单）

打开命令提示符（按 Win + R，输入 cmd）
输入以下命令并回车：
```
pip install opencv-python==3.4.2.17
```
```
pip install opencv-contrib-python==3.4.2.17
```
第一行安装基本的OpenCV，第二行安装扩展模块。

方法二：手动下载安装 如果上面的方法速度慢或失败，可以：

在浏览器中搜索“opencv_python-3.4.2.17-cp37-cp37m-win_amd64.whl”
下载对应你Python版本的文件
在命令提示符中，先进入下载文件所在的文件夹
输入：
```
pip install 你下载的文件名.whl
```

2.3 验证OpenCV3安装

安装完成后，我们需要确认OpenCV3是否安装成功：

打开命令提示符
输入 python 并按回车，进入Python环境
输入以下代码：
```
import cv2
print(cv2.__version__)
```
如果显示“3.4.2”或类似的版本号，恭喜你！安装成功了。

三、 C++版本安装指南

如果你需要C++开发环境，可以按照以下步骤：

3.1 下载OpenCV3

访问OpenCV官网的发布页面
找到OpenCV 3.4.x版本（这是3.x系列中比较稳定的版本）
下载Windows版本的exe安装包

3.2 安装和配置

双击下载的exe文件，它实际上是一个自解压压缩包
选择解压路径，比如 C:\opencv
等待解压完成

3.3 配置Visual Studio

安装Visual Studio 2017或2019（社区版免费）
创建一个新的C++项目
配置包含目录和库目录：
- 包含目录添加：C:\opencv\build\include
- 库目录添加：C:\opencv\build\x64\vc15\lib（根据你的VS版本选择）
配置链接器：
- 附加依赖项添加：opencv_world340.lib（如果是Debug模式则用opencv_world340d.lib）
将C:\opencv\build\x64\vc15\bin添加到系统PATH环境变量

四、常见问题解决方案

4.1 导入cv2时提示“DLL加载失败”

问题原因：缺少必要的Visual C++运行库 解决方案：

下载并安装“Microsoft Visual C++ Redistributable”
选择适合你系统的版本（一般是x64）
重启电脑后重试

4.2 pip安装速度慢或失败

解决方案：

使用国内镜像源，在命令提示符中输入：

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

或者使用阿里云镜像：

pip install opencv-python -i https://mirrors.aliyun.com/pypi/simple/

4.3 版本兼容性问题

OpenCV3有多个子版本，建议选择：

OpenCV 3.4.2：最稳定的3.x版本
对应Python 3.6或3.7

避免使用Python 3.8+与OpenCV3的组合，可能会有兼容性问题。

五、第一个OpenCV程序测试

让我们写一个简单的程序来测试安装是否真正成功：

打开记事本，输入以下代码：
```
import cv2
```

读取一张图片（请将路径改为你电脑上的一张图片）

img = cv2.imread('C:/你的图片路径/图片名.jpg')

显示图片

cv2.imshow('My Image', img)

等待按键，然后关闭窗口

cv2.waitKey(0) cv2.destroyAllWindows()

print("OpenCV3运行成功！")


2. 将文件保存为 `test_opencv.py`
3. 在文件所在文件夹，按住Shift键并右键，选择“在此处打开命令窗口”
4. 输入 `python test_opencv.py` 运行程序

如果能看到图片显示，说明一切正常！

## 六、 进阶配置和优化建议

### 6.1 安装常用辅助库
为了更好的开发体验，建议安装：

pip install numpy matplotlib jupyter notebook


- NumPy：数值计算库，OpenCV的依赖
- Matplotlib：绘图库，方便显示图像
- Jupyter Notebook：交互式编程环境，适合学习和调试

### 6.2 配置开发环境
推荐使用VS Code或PyCharm作为开发工具：
1. **VS Code**：轻量级，免费
   - 安装Python扩展
   - 安装OpenCV代码提示插件
2. **PyCharm**：功能强大，社区版免费
   - 自动配置Python环境
   - 提供完善的调试功能

### 6.3 学习资源推荐
1. OpenCV官方文档（有中文翻译）
2. 官方示例代码：在OpenCV安装包的`samples`文件夹中
3. 在线教程：从简单的图像读取显示开始，逐步学习图像处理基础

## 七、 注意事项和避坑指南

1. **版本匹配很重要**：Python 3.6/3.7 + OpenCV 3.4.x是最稳定的组合
2. **安装顺序**：先安装Python，再安装OpenCV
3. **环境变量**：安装Python时一定要勾选“Add to PATH”
4. **权限问题**：如果安装失败，尝试以管理员身份运行命令提示符
5. **杀毒软件**：有时杀毒软件会误报，暂时关闭后重试安装
6. **网络问题**：使用国内镜像源可以大大加快下载速度
7. **磁盘空间**：确保有至少2GB的可用空间
8. **系统更新**：保持Windows系统更新到最新版本

## 八、 总结

安装OpenCV3在Windows上其实并不复杂，关键是要按照正确的步骤进行。对于新手来说，Python版本是最容易上手的路径。记住以下几个要点：

1. 选择正确的版本组合
2. 使用pip安装时添加国内镜像源
3. 安装完成后一定要验证
4. 从简单的示例程序开始测试

如果在安装过程中遇到问题，不要慌张。大多数问题都有明确的解决方案，可以通过错误信息在网上搜索找到答案。计算机视觉是一个很有趣的领域，OpenCV是进入这个领域的绝佳工具。安装只是第一步，接下来你可以开始学习图像处理的基本操作，开启你的计算机视觉之旅。

**最后的小提示**：在学习过程中，多动手实践，从修改示例代码开始，逐步尝试自己的创意。遇到问题可以查阅官方文档或参与技术社区讨论。祝你在OpenCV的学习道路上顺利前行！