📚 课程目录第2章环境搭建

2. 环境搭建

AI分拣机器人项目的落地，首先依赖一个稳定、可复现的软件运行环境。本章将围绕Python基础环境、深度学习框架（PyTorch与TensorFlow二选一或并存）、OpenCV计算机视觉库以及机械臂SDK四个核心部分，系统讲解安装顺序、版本匹配策略、验证方法及常见排障思路。环境搭建的质量直接决定后续模型训练、推理部署和机械臂联调的效率，因此必须遵循“先基础、后框架、再硬件”的递进原则。

2.1 核心原理：为什么环境搭建是AI分拣项目的“地基”

AI分拣机器人涉及视觉感知、决策推理和运动执行三个子系统，每个子系统都有独立的软件依赖。视觉子系统依赖OpenCV进行图像采集、预处理和结果可视化；决策子系统依赖深度学习框架加载目标检测模型（如YOLOv8、Faster R-CNN）进行推理；执行子系统依赖机械臂SDK将抓取坐标转换为关节运动指令。三者通过Python胶水语言串联，任何一层版本不匹配或依赖缺失，都会导致整个链路中断。

环境搭建的核心原则是版本锁定与隔离。深度学习框架对Python版本、CUDA版本、cuDNN版本有严格约束，而OpenCV和机械臂SDK相对宽松。使用Anaconda创建独立虚拟环境，可以为每个项目锁定一套经过验证的依赖组合，避免“升级一个库导致另一个库崩溃”的连锁反应。例如，PyTorch 2.0在Python 3.11上运行良好，但TensorFlow 2.10以下版本不支持Python 3.10以上，若盲目升级Python版本，将导致框架无法导入。

  环境搭建的“木桶效应”：整个AI分拣系统的性能取决于最短的那块板。即使深度学习框架和OpenCV安装完美，如果机械臂SDK的串口通信库版本过旧，导致指令发送延迟超过50ms，分拣节拍依然无法达标。因此，每个组件的版本选择都要从系统整体出发，而非单独追求最新版本。

2.2 操作流程：从零搭建完整开发环境

以下操作流程以Windows 10/11 + NVIDIA GPU（可选）为基准，Linux/macOS用户可参考调整。整个流程分为五个步骤，每步都附带验证命令。

步骤一：安装Anaconda与创建虚拟环境

# 下载Anaconda 2024.xx版本（Python 3.11内置）
# 安装时勾选"Add to PATH"（可选，但建议手动配置）

# 创建独立虚拟环境
conda create -n ai_sorting python=3.9 -y
conda activate ai_sorting

# 验证Python版本
python --version
# 输出：Python 3.9.18

选择Python 3.9而非3.11，是因为TensorFlow 2.10（最后一个原生支持GPU的Windows版本）仅支持到Python 3.9。如果项目确定只用PyTorch，可以选用Python 3.10或3.11。

步骤二：安装深度学习框架

# 方式一：PyTorch（推荐，动态图更适合快速迭代）
# 先确认CUDA版本：nvidia-smi 查看Driver Version和CUDA Version
# 以CUDA 11.8为例
pip install torch==2.0.1 torchvision==0.15.2 torchaudio==2.0.2 --index-url https://download.pytorch.org/whl/cu118

# 方式二：TensorFlow（若项目需要部署到TensorRT）
pip install tensorflow==2.10.0

# 验证PyTorch GPU可用性
python -c "import torch; print(torch.__version__, torch.cuda.is_available())"
# 输出：2.0.1+cu118 True

GPU版本匹配陷阱：不要直接使用 pip install torch 安装默认版本，它会拉取CPU版本或与本地CUDA不匹配的预编译包。务必通过PyTorch官网的版本匹配表选择对应CUDA的安装命令。若没有NVIDIA GPU，可安装CPU版本，但推理速度会慢5-10倍，建议至少使用GTX 1660以上显卡。

步骤三：安装OpenCV

# 安装OpenCV主库和扩展库（二选一，推荐contrib）
pip install opencv-python==4.8.1.78
pip install opencv-contrib-python==4.8.1.78

# 验证OpenCV版本和关键模块
python -c "import cv2; print(cv2.__version__); print(cv2.getBuildInformation())"
# 输出：4.8.1
# 检查是否包含dnn模块（用于深度学习推理）

OpenCV的dnn模块可以直接加载ONNX格式的目标检测模型，这在某些场景下可以替代PyTorch/TensorFlow进行推理，减少依赖。但本项目仍以深度学习框架为主，OpenCV主要负责图像采集和预处理。

步骤四：安装机械臂SDK

# 以常见的Dobot Magician机械臂为例
# 方式一：官方SDK（Python包）
pip install DobotSDK==1.0.0

# 方式二：从源码安装（推荐，便于二次开发）
git clone https://github.com/Dobot-Arm/Dobot-SDK.git
cd Dobot-SDK
python setup.py install

# 验证SDK连接（需先连接机械臂USB或网口）
python -c "from DobotSDK import Dobot; print('SDK imported successfully')"

机械臂SDK通常依赖pyserial（串口通信）或socket（网络通信）。安装前需确认机械臂的通信协议（串口波特率、TCP端口号），并在设备管理器中查看分配的COM端口号。

步骤五：安装辅助库与整体验证

# 安装常用辅助库
pip install numpy==1.24.3 matplotlib==3.7.2 scipy==1.10.1
pip install jupyter notebook

# 整体验证脚本
python -c "
import torch, cv2, numpy as np
from DobotSDK import Dobot
print('PyTorch:', torch.__version__)
print('OpenCV:', cv2.__version__)
print('NumPy:', np.__version__)
print('Dobot SDK loaded')
# 测试张量计算
x = torch.rand(3, 3).cuda()
print('GPU tensor:', x.device)
"

2.3 案例拆解：一次真实的分拣项目环境搭建排障

某智能制造实训基地部署AI分拣机器人，硬件配置为：Intel i7-12700 + NVIDIA RTX 3060 12GB + Dobot Magician机械臂 + 海康威视工业相机。初始现象是：PyTorch模型推理正常，但机械臂SDK无法连接，且OpenCV读取相机图像时出现花屏。

排障过程：

初步排查：使用 nvidia-smi 确认GPU驱动正常；使用 python -c "import torch; print(torch.cuda.is_available())" 返回True，排除深度学习框架问题。
机械臂SDK排查：检查设备管理器，发现COM端口为COM7，但SDK默认连接COM3。修改SDK初始化参数后，连接成功。进一步发现SDK版本为0.9.0，与机械臂固件2.1.0不兼容，导致回零指令无响应。升级SDK至1.0.0后解决。
OpenCV花屏排查：使用 cv2.VideoCapture(0) 测试，发现帧率只有5fps且图像撕裂。检查相机驱动，发现安装了错误的USB3.0驱动，导致带宽不足。重新安装官方驱动后，帧率恢复至30fps。

结果对比：排障前，整个系统从图像采集到机械臂动作的延迟约800ms；排障后降至200ms，满足分拣节拍要求。复盘经验：环境搭建必须逐层验证，不能假设“安装成功=运行正常”。每个组件都要用最小化测试脚本验证其核心功能。

2.4 常见误区与总结复盘

误区	后果	正确做法
使用系统Python直接安装所有库	依赖冲突，升级系统包导致项目崩溃	使用conda创建独立虚拟环境
盲目安装最新版本框架	与CUDA、Python版本不兼容	参考官方版本匹配表，锁定版本
忽略OpenCV contrib模块	缺少SIFT、ARUCO等关键算法	安装opencv-contrib-python
机械臂SDK使用默认参数	串口/网络连接失败	根据设备管理器确认COM端口和波特率
不进行GPU验证	模型实际在CPU上运行，速度极慢	用 `torch.cuda.is_available()` 验证

总结：环境搭建的本质是依赖管理。建议将整个环境导出为YAML文件，方便团队协作和复现：

conda env export > environment.yml
# 新机器上恢复环境
conda env create -f environment.yml

经验提醒：在项目初期就建立“环境验证脚本”（如 check_env.py），每次修改依赖后运行一次，确保所有组件仍然协同工作。这比在联调阶段排查问题节省数倍时间。

完成本章环境搭建后，读者应具备一个可运行AI分拣机器人代码的完整开发环境。下一阶段将进入相机标定与图像采集模块，届时将直接使用本章配置的OpenCV和深度学习框架进行实战。