4. 环境搭建：Python + OpenCV + NumPy 开发环境配置
说实话，很多初学者在算法上花的时间不少，最后却卡在环境配置上。我见过太多人因为装库装到崩溃，直接放弃了整个项目。所以这一章，咱们先把地基打牢。
你想想看，镜头阴影校正和去噪滤波，本质上就是矩阵运算加图像处理。Python 负责调度，NumPy 负责算，OpenCV 负责读写和显示。三个东西配合好了，后面 26 章才能跑得顺。
4.1 为什么是这套组合？
我刚开始做图像处理时，用的是 C++ 加 OpenCV。后来转到 Python，发现开发效率至少提升了三倍。调试的时候不用编译，改一行代码立刻能看到效果。对于算法验证阶段来说，这太重要了。
| 组件 | 版本建议 | 核心作用 |
|---|---|---|
| Python | 3.8 - 3.11 | 胶水语言，调度整个流程 |
| NumPy | 1.24.x | 矩阵运算，图像本质就是矩阵 |
| OpenCV | 4.8.x 或 4.9.x | 图像读写、滤波、显示 |
核心观点： 图像在计算机里就是 NumPy 数组。你学会了操作数组，就等于学会了操作图像。OpenCV 只是帮你把数组显示成图片而已。
4.2 安装步骤（Windows / macOS / Linux）
我个人习惯用 pip 安装，简单直接。如果你用 Anaconda，那也行，但要注意 conda 和 pip 混用容易出问题。我建议你选一个，别来回切换。
4.2.1 确认 Python 版本
先打开终端，敲下面这行：
python --version如果版本低于 3.8，建议升级。为什么？因为有些新版的 OpenCV 已经不再支持 Python 3.7 了。我曾经在一个老项目上吃过这个亏，折腾了半天才发现是版本不兼容。
4.2.2 安装 NumPy
pip install numpy==1.24.3这里我锁了版本号。你可能会问，为什么不装最新的？嗯，最新的 NumPy 有时候会和 OpenCV 的某些函数冲突。1.24.x 是我在多个项目中验证过的稳定版本。
4.2.3 安装 OpenCV
pip install opencv-python==4.8.1.78
pip install opencv-contrib-python==4.8.1.78第一个包是基础版，第二个包包含了额外的算法模块。咱们后面做特征匹配时会用到 contrib 里的东西，所以建议两个都装上。
注意： 不要同时装 opencv-python 和 opencv-contrib-python 的不同版本。我曾经遇到过两个版本不一致，导致 imread 函数直接崩溃。解决方案是卸载重装，保持版本号完全一致。
4.2.4 验证安装
装完之后，跑一下这个脚本：
import numpy as np
import cv2
print("NumPy version:", np.__version__)
print("OpenCV version:", cv2.__version__)
# 创建一个 256x256 的灰色图像
img = np.zeros((256, 256, 3), dtype=np.uint8)
img[:] = (128, 128, 128)
# 显示图像
cv2.imshow("Test Window", img)
cv2.waitKey(0)
cv2.destroyAllWindows()如果弹出一个灰色窗口，说明环境搭建成功。如果报错，别慌。90% 的问题都是版本冲突，卸载重装基本能解决。
4.3 开发工具推荐
我个人推荐 VS Code，轻量、插件丰富。当然，PyCharm 也行，看个人习惯。我建议你装这几个插件：
- Python（微软官方）—— 语法高亮、调试
- Jupyter —— 交互式调试，特别适合图像处理
- GitLens —— 版本管理，方便回退
小技巧： 用 Jupyter Notebook 调试图像处理代码非常方便。你可以一边调整参数，一边看图像变化，不用每次都重新运行整个脚本。
4.4 本章知识体系
下面这张图，帮你理清环境搭建的核心逻辑：
4.5 常见问题与避坑
环境搭建这块，我踩过的坑比写过的代码还多。下面列几个最常见的：
- pip 安装超时： 国内用户建议换清华源或阿里源。命令：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple 包名 - OpenCV 无法显示窗口： 检查一下是不是在远程服务器上跑的。如果是，改用
cv2.imwrite()保存到本地查看。 - NumPy 和 OpenCV 版本冲突： 我遇到过 NumPy 1.25 导致 OpenCV 的某些函数报错。解决方案：降级到 1.24.x。
避坑指南： 我曾经在 Windows 上同时装了 Python 3.7 和 3.10，结果 pip 指向了旧版本，OpenCV 怎么都装不上。后来把旧版本彻底卸载，只留一个 Python，问题就解决了。建议你只保留一个 Python 版本。
4.6 快速验证脚本
最后，给你一个完整的验证脚本。跑通了，说明环境没问题，咱们就可以进入下一章了。
import numpy as np
import cv2
# 生成一张渐变图像
width, height = 512, 512
img = np.zeros((height, width, 3), dtype=np.uint8)
for y in range(height):
for x in range(width):
img[y, x] = [x % 256, y % 256, (x + y) % 256]
# 保存图像
cv2.imwrite("test_gradient.png", img)
print("图像已保存：test_gradient.png")
# 读取并显示
img_read = cv2.imread("test_gradient.png")
print("图像尺寸：", img_read.shape)
print("数据类型：", img_read.dtype)
print("像素值范围：", img_read.min(), "-", img_read.max())如果输出正常，说明你的 Python + NumPy + OpenCV 环境已经全部就绪。后面咱们就可以直接上手做镜头阴影校正和去噪滤波了。