第二章:开发环境搭建

说实话,很多初学者在学热成像开发时,第一步就被环境搭建给卡住了。我见过不少同事,明明代码逻辑没问题,结果因为OpenCV版本不对、PyQt5和Python版本不兼容,折腾一整天。嗯,这一章我们就来把这套环境捋顺。

本章核心目标:搭建一套稳定的热成像上位机开发环境,包括Python、PyCharm、OpenCV、PyQt5和串口通信库。

2.1 Python环境配置

我个人习惯用Python 3.8或3.9版本。为什么?因为OpenCV和PyQt5在这两个版本上最稳定。我曾经用Python 3.11装OpenCV,结果一堆兼容性问题,折腾了两天才搞定。

安装步骤:

  1. 去Python官网下载对应版本(建议3.8.10或3.9.13)
  2. 安装时记得勾选「Add Python to PATH」
  3. 打开命令行,输入 python --version 验证

小技巧:我建议用虚拟环境来管理项目依赖。每个项目独立的环境,互不干扰。用 python -m venv venv 创建,用 venv\Scripts\activate 激活。

2.2 PyCharm安装与配置

PyCharm分专业版和社区版。做热成像上位机开发,社区版完全够用。说白了,专业版那些数据库工具、远程开发功能,咱们基本用不上。

配置要点:

  • 安装后打开PyCharm,点击File → Settings
  • 在Project Interpreter里选择刚才创建的虚拟环境
  • 字体建议设置为Consolas或JetBrains Mono,14号字

注意:我曾经遇到过PyCharm识别不到虚拟环境的情况。解决办法很简单:在Settings里手动添加Python解释器路径,指向虚拟环境里的python.exe。

2.3 OpenCV库安装

OpenCV是热成像图像处理的核心库。安装命令很简单:

pip install opencv-python
pip install opencv-contrib-python  # 包含额外模块

你想想看,热成像的原始数据其实就是温度矩阵,OpenCV能帮我们把这个矩阵渲染成伪彩色图像。我在项目中常用的是COLORMAP_JET和COLORMAP_INFERNO两种色图。

验证安装:

import cv2
print(cv2.__version__)  # 输出版本号,比如4.5.5

2.4 PyQt5库安装

PyQt5用来做上位机的界面。为什么选它?因为Qt的控件丰富,而且和OpenCV配合得很好。

pip install PyQt5
pip install PyQt5-tools  # 包含Qt Designer

安装完成后,你可以在Python安装目录的Scripts文件夹里找到 designer.exe。这就是Qt Designer,拖拽式设计界面,非常方便。

个人经验:我建议先用Qt Designer画界面,再用PyUIC把.ui文件转成.py文件。命令是:pyuic5 -x input.ui -o output.py。这样比手写界面代码快多了。

2.5 串口通信库安装

热成像仪通常通过串口(RS232/RS485)或USB虚拟串口与上位机通信。所以我们需要安装pyserial库:

pip install pyserial

这个库的使用也很直观:

import serial

ser = serial.Serial(
    port='COM3',      # Windows下是COM口,Linux下是/dev/ttyUSB0
    baudrate=115200,  # 热成像仪常用波特率
    timeout=1
)

data = ser.read(1024)  # 读取数据
ser.close()

避坑指南:我曾经遇到过串口打不开的问题。原因往往是端口被占用,或者波特率设置不对。建议先用串口调试工具(比如SSCOM)测试一下,确认参数没问题再写代码。

2.6 环境搭建知识体系

下面这张图展示了整个开发环境的层次结构:

热成像上位机开发环境结构 操作系统层(Windows/Linux) Python 3.8/3.9 解释器 OpenCV 图像处理 PyQt5 界面开发 pyserial 串口通信 热成像上位机应用程序

从这张图可以看出,整个环境是分层搭建的。底层是操作系统,中间是Python解释器,再上面是三个核心库,最后才是我们的应用程序。每一层都依赖下一层,所以安装顺序很重要。

2.7 环境验证

安装完成后,我建议写一个简单的测试脚本,验证所有库是否正常工作:

import cv2
import PyQt5
import serial

print("OpenCV版本:", cv2.__version__)
print("PyQt5版本:", PyQt5.QtCore.PYQT_VERSION_STR)
print("pyserial版本:", serial.__version__)
print("环境搭建成功!")

如果都能正常输出版本号,恭喜你,环境搭建完成了。接下来就可以开始真正的热成像开发了。

总结一下:这一章我们安装了Python、PyCharm、OpenCV、PyQt5和pyserial。这些工具就像工具箱里的扳手和螺丝刀,有了它们,我们才能开始组装热成像上位机这个大家伙。


专注资料整理