2. 开发环境搭建与项目创建
VisionPro 深度学习视觉检测平台的开发环境搭建，核心不是“把软件装上”，而是让三件事同时成立：VisionPro 主程序能正常启动、Deep Learning 许可被正确识别、图像源与作业结构能够稳定跑通一次检测。很多初学者在安装后直接新建项目，结果在加载深度学习工具时报许可错误，或在取像阶段就卡住，根本原因往往出在环境配置顺序或许可绑定方式上。本节按“安装配置 → 许可管理 → 新建项目 → 图像源接入 → 作业结构”的实际落地顺序展开，并给出可复现的配置样例与判断依据。
一、VisionPro 安装与运行环境确认
VisionPro 是 Cognex 的机器视觉软件平台，深度学习功能以工具形式集成在 QuickBuild 与 VisionPro Deep Learning 环境中。安装前先确认三项基础条件：操作系统版本（通常为 Windows 10/11 64 位专业版或企业版）、.NET 运行库版本、以及显卡与驱动。深度学习推理对 GPU 有依赖，若使用 GPU 加速，需确认 NVIDIA 驱动与 CUDA 版本匹配；若仅用 CPU 推理，速度会明显下降，但可用于功能验证。
安装时建议以管理员身份运行安装包，选择完整安装而非自定义裁剪，避免漏装 Deep Learning 运行时组件。安装完成后，先不要急于打开项目，而是依次验证：VisionPro 主界面能否启动、QuickBuild 能否新建作业、示例图像能否被读取。这一步是后续所有配置的前提。
二、Deep Learning 许可管理
VisionPro 的深度学习许可通常通过加密狗（USB Dongle）或软授权方式管理。许可决定了可用的深度学习工具类型与并发数量。常见做法是：将加密狗插入主机 USB 口，安装驱动后，在 VisionPro 的许可管理界面中查看许可状态。若显示“未找到许可”或“许可过期”，需要检查驱动是否安装、加密狗是否被识别、以及许可是否与当前机器绑定。
软授权方式下，许可文件通常与机器码绑定。更换主机或重装系统后，需要重新申请或迁移许可。实际项目中，建议在开发机上固定使用同一台设备进行调试，避免频繁迁移导致许可失效。许可状态确认后，再进入项目创建环节，否则后续工具加载会反复报错。
三、新建 VisionPro 项目与作业结构
VisionPro 的项目通常以 QuickBuild 作业（Job）为核心组织单位。新建项目时，先创建一个空白作业，再逐步添加图像源与工具。作业结构可以理解为一条数据流：图像源提供输入图像，工具组对图像进行处理，结果输出用于判断合格与否。深度学习工具（如 Deep Learning 分类、分割、检测）作为工具组中的节点接入，其输入来自图像源，输出为分类标签、掩膜或检测框。
实际创建时，建议先保存一个空白工程文件（.vpp），再依次添加图像源和工具。这样做的目的是让工程结构清晰，便于后续调试与版本管理。若一开始就堆叠大量工具，后期排查问题时很难定位是哪一级输入或参数出错。
四、图像源接入与取像配置
图像源可以是工业相机、图像文件或图像序列。开发阶段常用图像文件作为输入，便于反复调试；实际部署时切换为相机取像。接入图像源时，需要配置取像参数，例如曝光时间、增益、触发方式（软触发或硬触发）。以图像文件为例，选择一张待检测图像后，作业中会生成一个图像源节点，后续工具直接引用该节点输出。
若使用相机，需先安装相机驱动，再在 VisionPro 中通过图像采集接口连接。连接成功后，先做一次单帧取像，确认图像清晰、亮度合适、无丢帧。这一步的判断依据是：图像能稳定显示，且直方图分布合理，没有过曝或过暗区域。
五、配置样例与检查要点
下面给出一个可参考的配置样例，用于验证环境是否搭建成功。该样例以图像文件为输入，添加一个深度学习分类工具，并输出分类结果。
1. 启动 VisionPro QuickBuild
2. 新建 Job，保存为 Demo_DeepLearning.vpp
3. 添加 Image Source，选择本地图像 sample_01.bmp
4. 添加 Deep Learning 分类工具，加载已训练模型 model_classify.vpp
5. 连接 Image Source 输出到分类工具输入
6. 运行一次，观察分类标签与置信度
7. 若置信度低于阈值，检查图像质量与模型匹配度运行后，若分类工具能正常输出标签与置信度，说明安装、许可、项目结构、图像源接入均已打通。若报许可错误，回到许可管理环节检查；若图像无法读取，检查图像路径与格式；若工具无法加载，检查深度学习运行时组件是否完整。
六、常见问题与排查方向
环境搭建阶段最常见的问题有三类：许可未识别、图像源无法取像、深度学习工具加载失败。许可问题通常表现为启动时提示“License not found”，解决方法是检查加密狗驱动与许可绑定状态。图像源问题表现为取像黑屏或报错，解决方法是检查相机连接、驱动与触发配置。工具加载失败则多与运行时组件或 GPU 驱动有关，可先切换为 CPU 模式验证功能是否正常，再排查 GPU 环境。