PySide6 + Qt Designer + PyCharm 完整开发流程

PyCharm 对 Python 桌面开发有更完善的支持，包括智能代码补全、断点调试、集成终端、版本控制等功能，结合 Qt Designer 的可视化 UI 设计，是工业级上位机开发的首选组合。以下是完全适配 PyCharm 的标准化开发流程。

一、环境准备与 PyCharm 配置

1. 创建项目并配置虚拟环境（必做）

PyCharm 强烈推荐使用虚拟环境隔离项目依赖，避免版本冲突：

打开 PyCharm → 新建项目 (New Project)
选择项目位置，命名为test_equipment_app（示例）
勾选 "New environment using Virtualenv"，保持默认 Python 解释器
取消勾选 "Create a main.py welcome script"
点击 "Create" 完成项目创建

2. 安装 PySide6 核心依赖

在 PyCharm 底部的Terminal终端中执行：

1# 安装指定稳定版本（推荐6.7.2，与STM32上位机兼容性最好）
2pip install pyside6==6.7.2
3
4# 验证安装（终端执行）
5python -c "import PySide6; print(f'PySide6版本: {PySide6.__version__}')"

3. 配置 PyCharm 外部工具（核心步骤）

这是 PyCharm 与 Qt Designer 联动的关键，配置后可一键打开设计器、转换 UI / 资源文件：

步骤 1：打开外部工具配置界面

菜单栏：File → Settings → Tools → External Tools
点击左上角+号，依次添加以下 3 个工具

步骤 2：添加 Qt Designer 工具

配置项	值	说明
Name	Qt Designer	工具显示名称
Program	pyside6-designer	系统自动识别的命令
Arguments	$FilePath$	直接打开当前选中的.ui 文件
Working directory	$FileDir$	工作目录为文件所在目录
Advanced Options	取消勾选 "Synchronize files after execution"	避免不必要的文件同步

步骤 3：添加 UI 转 Python 工具

配置项	值
Name	UI 转 Python
Program	pyside6-uic
Arguments	$FileName$ -o $FileNameWithoutExtension$_ui.py --from-imports
Working directory	$FileDir$

步骤 4：添加资源转 Python 工具

配置项	值
Name	资源转 Python
Program	pyside6-rcc
Arguments	$FileName$ -o $FileNameWithoutExtension$_rc.py
Working directory	$FileDir$

配置完成验证

右键点击项目中任意位置 → 选择External Tools，能看到刚才添加的 3 个工具即配置成功。

4. 安装 PyCharm 增强插件（推荐）

PySide6 Plugin：提供 UI 文件预览、信号槽导航、QSS 语法高亮
.ignore：自动生成.gitignore 文件，排除__pycache__、dist 等目录
Rainbow Brackets：彩虹括号，提升代码可读性

二、PyCharm 专属项目结构（最佳实践）

创建以下目录结构，并右键点击根目录 → Mark Directory as → Sources Root（解决导入红色波浪线问题）：

1test_equipment_app/
2├── main.py                # 程序唯一入口
3├── ui/                    # 自动生成的UI代码（禁止手动修改）
4│   ├── main_window.ui     # Qt Designer设计文件
5│   ├── main_window_ui.py  # uic转换后的Python代码
6│   ├── setting_dialog.ui
7│   └── setting_dialog_ui.py
8├── views/                 # UI逻辑层（信号槽绑定、界面交互）
9│   ├── main_window.py     # 主窗口逻辑类
10│   └── setting_dialog.py  # 设置对话框逻辑类
11├── core/                  # 核心业务逻辑（纯Python，无UI依赖）
12│   ├── serial_port.py     # 串口通信（STM32/FPGA）
13│   ├── data_processor.py  # 测试数据处理
14│   └── test_case.py       # 测试用例执行
15├── resources/             # 资源文件
16│   ├── icons/             # 按钮图标、窗口图标
17│   ├── qss/               # 样式表文件
18│   └── resources.qrc      # Qt资源清单
19├── config/                # 配置文件
20│   └── app_config.ini     # 串口参数、测试参数
21├── tests/                 # 单元测试
22├── requirements.txt       # 依赖清单
23└── .gitignore             # Git忽略文件

三、Qt Designer UI 设计流程（PyCharm 集成）

1. 快速启动 Qt Designer

在 PyCharm 中右键点击ui/目录 → External Tools → Qt Designer，直接在该目录下创建 UI 文件。

2. 核心设计规范（针对测试设备上位机）

选择正确的窗口模板：
- 主窗口：Main Window（带菜单栏、工具栏、状态栏，适合主界面）
- 参数设置：Dialog with Buttons Right（带确定 / 取消按钮）
- 自定义控件：Widget（如串口配置面板、数据显示面板）
控件命名规范（强制）：后续代码通过objectName访问控件，必须统一命名：

控件类型	前缀	示例
QPushButton	btn_	btn_connect_serial、btn_start_test
QLineEdit	txt_	txt_serial_port、txt_baud_rate
QComboBox	cbx_	cbx_baud_rate、cbx_parity
QLabel	lbl_	lbl_status、lbl_test_result
QTableWidget	tbl_	tbl_test_data
QCheckBox	chk_	chk_auto_save

布局管理（关键）：
- 绝对禁止使用拖拽定位（窗口缩放必错位）
- 优先使用QVBoxLayout（垂直）和QHBoxLayout（水平）
- 复杂界面使用QGridLayout（网格）
- 最后点击主窗口空白处 → 右键 → 布局 → 选择整体布局
- 通过Layout属性调整间距 (margin) 和边距 (spacing)
保存 UI 文件：保存到ui/目录，命名为main_window.ui

四、UI 文件转换与代码集成

1. 一键转换 UI 文件

在 PyCharm 中右键点击ui/main_window.ui → External Tools → UI转Python，自动生成main_window_ui.py。

重要提醒：

绝对不要手动修改_ui.py文件，每次 UI 修改后重新转换即可
转换时自动添加的--from-imports参数会生成相对导入，避免路径问题

2. 创建视图逻辑类（UI 与逻辑分离）

在views/目录下创建main_window.py，继承自 Qt 基类和自动生成的 UI 类：

1from PySide6.QtWidgets import QMainWindow, QMessageBox
2from PySide6.QtCore import Qt
3from ui.main_window_ui import Ui_MainWindow
4from core.serial_port import SerialPortManager
5
6class MainWindow(QMainWindow, Ui_MainWindow):
7    def __init__(self):
8        super().__init__()
9        # 初始化UI（自动创建所有控件）
10        self.setupUi(self)
11        # 设置窗口标题和大小
12        self.setWindowTitle("芯片测试设备上位机")
13        self.resize(1200, 800)
14        # 初始化业务逻辑对象
15        self.serial_manager = SerialPortManager()
16        # 绑定所有信号与槽
17        self._connect_signals()
18        # 初始化界面数据
19        self._init_ui()
20
21    def _connect_signals(self):
22        """统一管理所有信号槽绑定"""
23        # 串口连接按钮
24        self.btn_connect_serial.clicked.connect(self.on_connect_serial_clicked)
25        # 开始测试按钮
26        self.btn_start_test.clicked.connect(self.on_start_test_clicked)
27        # 串口接收数据信号（自定义信号）
28        self.serial_manager.data_received.connect(self.on_serial_data_received)
29
30    def _init_ui(self):
31        """初始化界面显示"""
32        # 初始化串口波特率下拉框
33        self.cbx_baud_rate.addItems(["9600", "19200", "38400", "115200", "921600"])
34        self.cbx_baud_rate.setCurrentText("115200")
35        # 状态栏显示
36        self.statusBar().showMessage("设备未连接")
37        # 默认禁用测试按钮
38        self.btn_start_test.setEnabled(False)
39
40    # ------------------------------ 槽函数 ------------------------------
41    def on_connect_serial_clicked(self):
42        """串口连接按钮点击事件"""
43        port = self.txt_serial_port.text().strip()
44        baud_rate = int(self.cbx_baud_rate.currentText())
45
46        if not port:
47            QMessageBox.warning(self, "警告", "请输入串口号")
48            return
49
50        try:
51            if self.serial_manager.is_connected():
52                self.serial_manager.disconnect()
53                self.btn_connect_serial.setText("连接串口")
54                self.btn_start_test.setEnabled(False)
55                self.statusBar().showMessage("设备已断开")
56            else:
57                self.serial_manager.connect(port, baud_rate)
58                self.btn_connect_serial.setText("断开串口")
59                self.btn_start_test.setEnabled(True)
60                self.statusBar().showMessage(f"已连接到 {port} @ {baud_rate}bps")
61        except Exception as e:
62            QMessageBox.critical(self, "错误", f"串口连接失败：{str(e)}")
63
64    def on_start_test_clicked(self):
65        """开始测试按钮点击事件"""
66        try:
67            self.serial_manager.send_command("START_TEST")
68            self.statusBar().showMessage("测试进行中...")
69            self.btn_start_test.setEnabled(False)
70        except Exception as e:
71            QMessageBox.critical(self, "错误", f"测试启动失败：{str(e)}")
72
73    def on_serial_data_received(self, data):
74        """串口数据接收事件"""
75        # 在UI线程中更新数据显示
76        self.tbl_test_data.append(data)
77        self.statusBar().showMessage(f"收到数据：{data}")

3. 创建程序入口

在项目根目录创建main.py：

1import sys
2from PySide6.QtWidgets import QApplication
3from views.main_window import MainWindow
4
5if __name__ == "__main__":
6    # 启用高DPI支持（解决4K屏幕模糊问题）
7    QApplication.setHighDpiScaleFactorRoundingPolicy(Qt.HighDpiScaleFactorRoundingPolicy.PassThrough)
8    
9    app = QApplication(sys.argv)
10    window = MainWindow()
11    window.show()
12    sys.exit(app.exec())

4. 运行程序

在 PyCharm 中右键点击main.py → Run 'main'，即可启动应用。

五、PyCharm 专属调试技巧（核心优势）

PyCharm 的调试功能是其最大优势，特别适合排查串口通信、数据处理等复杂问题：

1. 基础调试操作

设置断点：点击代码行号左侧的空白处，出现红色圆点即断点设置成功
启动调试：右键点击main.py → Debug 'main'（快捷键 Shift+F9）
单步执行：F8（步过）、F7（步入）、Shift+F8（步出）
查看变量：在 Debug 面板的 Variables 窗口查看所有变量值
监视表达式：在 Watches 窗口添加需要监视的变量或表达式

2. 高级调试技巧

异常断点：在 Debug 面板点击View Breakpoints → 勾选Any Exception，程序抛出异常时自动暂停
条件断点：右键点击断点 → 设置条件（如data == "TEST_PASS"），满足条件时才暂停
日志断点：右键点击断点 → 取消勾选 "Suspend"，勾选 "Log message to console"，不暂停程序只输出日志
附加到进程：如果程序已经运行，可以通过Run → Attach to Process附加调试

3. 常见问题排查

导入错误：确认根目录已标记为 Sources Root
UI 修改不生效：确认已右键转换 UI 文件，且运行的是最新代码
串口数据不更新：检查串口通信是否在 QThread 中运行（避免阻塞 UI 线程）
程序闪退：启用异常断点，定位崩溃位置

六、资源文件与样式表处理

1. 资源文件配置

在resources/目录创建resources.qrc：

1<RCC>
2    <qresource prefix="/">
3        <file>icons/connect.png</file>
4        <file>icons/start.png</file>
5        <file>qss/style.qss</file>
6    </qresource>
7</RCC>

2. QSS 样式表美化

在resources/qss/目录创建style.qss，编写样式
在MainWindow.__init__中加载：

1# 加载全局样式表
2with open("resources/qss/style.qss", "r", encoding="utf-8") as f:
3    self.setStyleSheet(f.read())

七、打包与分发（PyCharm 集成）

1. 安装 PyInstaller

pip install pyinstaller

2. 配置 PyCharm 打包运行配置

菜单栏：Run → Edit Configurations
点击+ → 选择Python
配置参数：
- Name：打包应用
- Script path：选择pyinstaller.exe路径（虚拟环境下的Scripts/pyinstaller.exe）
- Parameters：-F -w -i resources/icons/app.ico --add-data "resources/qss;resources/qss" --add-data "config;config" main.py
点击 "OK" 保存

3. 一键打包

点击 PyCharm 右上角的运行按钮，选择 "打包应用"，即可自动打包。打包完成后，可执行文件生成在dist/目录下。

八、PyCharm 专属最佳实践

使用 QThread 处理耗时任务：串口通信、数据采集、测试用例执行等必须放在子线程，避免界面卡顿

1from PySide6.QtCore import QThread, Signal
2
3class TestThread(QThread):
4    test_finished = Signal(bool)
5    progress_updated = Signal(int)
6
7    def run(self):
8        for i in range(101):
9            self.progress_updated.emit(i)
10            self.msleep(100)
11        self.test_finished.emit(True)

使用 PyCharm 的重构功能：重命名控件、方法时，PyCharm 会自动更新所有引用，避免手动修改出错
代码模板：在File → Settings → Editor → File and Code Templates中添加自定义模板，快速创建主窗口、对话框等文件
版本控制：PyCharm 集成 Git，提交时自动忽略_ui.py、_rc.py、__pycache__等自动生成文件

《PySide6 + Qt Designer + PyCharm 完整开发流程》是转载文章，点击查看原文。