PySide6实战：按面板拆解桌面应用界面开发与性能优化

PySide6 这套 Qt 官方绑定库，我是从 PyQt5 转过来的。当年还能靠 endless 复制粘贴过日子，等真正开始接完整项目，才发现组件之间“谁该放在哪、谁来管数据、谁来画界面”如果没有一套清楚的分法，代码早晚变成一团浆糊。网上写 PySide6 教程的不少，但大部分是按类继承关系一个个讲，看完记不住，用的时候更不知道怎么搭。我这篇换个思路，按照“面板分类”来拆——把界面理解成一块块区域，每个区域需要什么组件、组件之间的协作关系是什么，全部对照实际项目讲清楚。

这篇文章适合三类人：刚接触 PySide6 想快速找到学习路径的新人、从 PyQt4/5 转过来的老人，还有一种最容易被忽略——写了两年 CRUD 界面，但一碰上表格卡顿、界面布局混乱、多页面切换无从下手的人。接下来我不会堆官方文档，直接拿我做桌面工具项目时的真实面板来拆。

1. 面板分类的整体思路与设计考量

1.1 为什么要按面板而不是按继承关系学

Qt 的类继承树少说有三层，最顶层是 QObject，下面是 QWidget，再下面才是按钮、表格、对话框这些具体组件。多数教程会从 QWidget 讲起，然后照着 QPushButton → QLineEdit → QTableWidget 的顺序逐个给你看 API。这个方法的问题在于：所有组件被“摊平”了，你脑子里记住的只是一个一个孤立的名字，到了真正设计界面的时候，依然不知道哪个组件放在哪个位置。

我平时做界面，第一步永远是画一张“面板草图”。就像盖房子之前先画户型图，哪个房间干什么用，再决定每个房间放什么家具。桌面软件的界面通常可以拆成几个固定面板：最外层是窗口框架，顶部是菜单工具栏，中间是数据展示区，左面可能是导航树，右面是表单输入区，底部是状态栏，必要的时候还有弹窗和图表区。想清楚房间，再去选家具，组件的职责就清晰了。

1.2 本文的面板划分方式总览

我把 PySide6 的核心组件按实际功能窝分成了六个面板，后续每个章节对应一个面板。

这个分类并不严格对应 Qt 的类层次，但它对应开发时的“心智模型”。写代码时你脑子里想的是“我现在在搭导航面板”而不是“我现在要 new 一个 QTabWidget”。这套思路我用了三年，效率提升是实打实的。

2. 窗口框架面板：搭出应用的骨架

2.1 QMainWindow 与中央部件的关系

几乎所有正经桌面软件都以 QMainWindow 作为主窗口。QMainWindow 是一个预制好的“骨架”，自带菜单栏区域、工具栏区域、状态栏区域、停靠窗口区域和中间的中央部件区。你需要做的只是把中央部件 setCentralWidget 进去。

有一个经常让新手翻车的点：QMainWindow 不能直接塞布局。很多人写了self.setLayout(layout)发现界面毫无变化，原因就是 QMainWindow 本身不参与布局管理。正确做法是先创建一个 QWidget 作为中央容器，在该容器上 setLayout，然后传给 setCentralWidget。这个错误我在调试群里每个月都能看到好几次。

在实际项目中，我通常会把主窗口写成下面这样：

class MainWindow(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle("资产管理工具") self.resize(1280, 800) central_widget = QWidget(self) self.setCentralWidget(central_widget) layout = QVBoxLayout(central_widget) layout.addWidget(self.build_table_panel()) # 数据展示面板 layout.addWidget(self.build_input_panel()) # 输入控件面板

中央部件是整个窗口的灵魂，它承载了其余所有面板。窗口只负责外壳，内容全在中央部件里，这个思路一定要刻在脑子里。

2.2 菜单栏、工具栏与状态栏是三个独立面板

菜单栏用 QMenuBar，工具栏用 QToolBar，状态栏用 QStatusBar。它们虽然都属于 QMainWindow 的一部分，但是三个完全独立的面板，各自承担不同职责。

菜单栏适合放不常用的、有层级关系的操作。比如“文件 → 打开/保存/退出”“编辑 → 复制/粘贴”。QMenuBar 里加的是 QMenu，QMenu 里再 addAction。工具栏适合放高频操作，新建、打开、保存、撤销、重做这些。每个 QAction 可以同时放到菜单和工具栏里，只需将同一个 action 对象 add 到两处即可，这也是 Qt 一个非常贴心的设计——一处修改，两处生效。

状态栏 QStatusBar 最容易被忽略。我自己的经验是：任何耗时操作、任何加载进度、任何最近操作结果，都应该在状态栏留下痕迹。QStatusBar 支持showMessage()临时显示消息，也支持addWidget()常驻显示标签。举个例子，数据加载完成之后我在状态栏显示“共加载 12000 条记录，耗时 2.3 秒”，用户立刻知道程序没死。

2.3 无边框窗口与原生流畅度的取舍

很多做自定义皮肤的产品都要求去掉系统标题栏，改用setWindowFlags(Qt.FramelessWindowHint)，好处是界面统一好看，代价是你要自己实现拖动、缩放、关闭按钮。这个需求的坑比想象中多。

无边框窗口的第一个大坑是拖动。在鼠标按下事件里记录偏移量，在鼠标移动事件里调用self.move()。第二个坑是缩放，无边框窗口的缩放不会自动处理，你需要继承 QMainWindow 之后重写 nativeEvent，在 Windows 的 WM_NCHITTEST 消息里判断鼠标是否在边缘，返回对应区域代码。这部分属于平台相关代码，复杂度立刻上来了。

我的个人建议是：如果不是做播放器、游戏启动器这种对 UI 一致性要求极高的产品，不要轻易上无边框。如果非要上，至少用Qt.FramelessWindowHint | Qt.WindowMinMaxButtonsHint保留部分系统行为，或者借助 QWindow 的原生接口。如果你追求 Windows 下的“原生丝滑”，妥协方案是保留系统标题栏，只自定义内容区域的配色和控件样式，这才是性价比最高的路线。

3. 数据展示面板：从 QTableWidget 到自定义 Model

3.1 QTableWidget 为什么大数据下会卡

说到数据展示，PySide6 里最常用的是 QTableWidget。这个组件用起来极其顺手——它是一个“自包含”的表格，你直接调setItem(row, col, QTableWidgetItem(...))就能填数据，不用搞任何复杂结构。对于几百行的配置表、参数表，它是完美的选择。

但一旦数据量上到几千行、几万行，QTableWidget 就开始明显卡顿。根因很直接：QTableWidget 在内部为每一个单元格创建一个 QTableWidgetItem 对象。一万行乘十列就是十万个对象，每个对象都有独立的信号槽、属性和内存开销。这还只是创建，滚动的时候每个单元格都要被绘制，十多万个对象的遍历和绘制，帧率自然崩了。

很多人一开始想尽办法优化 QTableWidget：开启setUniformRowHeights(True)、关闭单元格编辑、减少触发信号……这些我都试过，只能说治标不治本。真正解决问题的路径只有一个：换 QTableView。

3.2 QTableView + QAbstractTableModel 的标准写法

QTableView 是视图层，它不保存数据，数据全在 Model 里。你只需要在data()里按需返回某个单元格的值。表格视图中可见的只有几十行，它就只向 Model 请求这几十行的数据，这就是它能在十万行数据下依然流畅的根本原因。

下面这个例子，我用 QAbstractTableModel 写了一个对十万行数据友好、只读的表格模型：

from PySide6.QtCore import QAbstractTableModel, Qt, QModelIndex class AssetTableModel(QAbstractTableModel): def __init__(self, data): super().__init__() self._data = data # list of lists def rowCount(self, parent=QModelIndex()): return len(self._data) def columnCount(self, parent=QModelIndex()): return len(self._data[0]) if self._data else 0 def data(self, index, role=Qt.DisplayRole): if not index.isValid(): return None if role == Qt.DisplayRole: return str(self._data[index.row()][index.column()]) return None def headerData(self, section, orientation, role): if role != Qt.DisplayRole: return None headers = ["资产编号", "名称", "类别", "状态"] if orientation == Qt.Horizontal and section < len(headers): return headers[section] return super().headerData(section, orientation, role)

使用的时候只需三行：

self.table_view = QTableView() self.table_model = AssetTableModel(big_data) self.table_view.setModel(self.table_model)

代码量比 QTableWidget 多了一点，但换来的收益是数量级级别的滚动流畅度。这个方案也是 Qt 官方文档推荐的表格大数据标准解法。

3.3 不只是表格：QListView 与 QTreeView 的模型思维

模型/视图架构不是 QTableView 的专利。QListView 展示列表，QTreeView 展示树形结构，它们的数据同样来自 QAbstractItemModel。一旦你理解了 Model/View 分离的哲学，这三类控件的学习成本就一通百通。

最常见的模式是：用 QFileSystemModel 配合 QTreeView 显示文件目录树。QFileSystemModel 是 Qt 内置的文件系统模型，你不需要手动读取文件列表，它直接帮你监听磁盘变更。类似地，如果要做多选、拖拽排序，QListView 通过设置setDragDropMode(QAbstractItemView.InternalMove)就能实现内部拖动排序；QTreeView 也支持同样的机制。

如果你做的是一个偏向业务逻辑的界面，我建议更进一步，把 Model 层当作独立的“数据服务”来使用，界面和业务逻辑分离。这套思路往深了走就是 Qt 圈子常说的 MVVM：View 只负责显示，Model 负责提供数据，中间通过信号槽解耦。用 Python 写界面时，这种解耦对后期维护的价值比写 C++ 时还要大，因为 Python 侧没有编译器帮你检查类型错误，清晰的数据流比什么都重要。

4. 输入控件面板：表单交互的基础积木

4.1 按钮族：状态与行为的区别

输入面板最底层的组件就是按钮。QPushButton 是最普通的触发按钮，点击执行一个动作。QToolButton 通常放在工具栏里，尺寸更紧凑，可以显示图标而不显示文字。QRadioButton 是单选框，同组内只能选一个。QCheckBox 是复选框，每个选项独立。

新手最容易搞混的是 QRadioButton 的“互斥”效果。默认情况下，同一父容器下的 QRadioButton 会自动互斥，但如果你把它们分别放在不同的 QGroupBox 或 QHBoxLayout 里，互斥就会失效。解决办法有两种：把多个 QRadioButton 放到同一个 QButtonGroup，或者让它们拥有同一个父对象。我习惯用 QButtonGroup，因为它还能让你通过buttonClicked信号知道当前选中了哪个按钮，这在业务处理中非常常见。

4.2 文本输入：QLineEdit、QTextEdit、QPlainTextEdit 三选一

文本输入有三个常用组件，很多人不知道它们之间的区别。QLineEdit 是单行输入，适合用户名、密码、搜索关键词这类短内容，支持setEchoMode(QLineEdit.Password)做密码掩码。QTextEdit 是富文本编辑器，支持设置字体颜色、插入图片等，适合做复杂的文档编辑。QPlainTextEdit 只显示纯文本，性能和内存都优于 QTextEdit，适合代码编辑器、日志查看器。

我做过一个日志查看面板，最初用了 QTextEdit，给日志加颜色之后几千行日志就开始卡顿。后来换成 QPlainTextEdit，性能立刻提升，虽然颜色渲染少了一些，但日志阅读场景完全够用。这个经验被我不止一次验证过：能用纯文本的地方，绝不用富文本。

4.3 数值输入与滑块：精度和体验的平衡

数值输入有 QSpinBox（整数）、QDoubleSpinBox（浮点数）、QSlider（滑块）。QSpinBox 和 QSlider 经常组合使用：一个负责精确输入，一个负责快速调节。两者之间通过信号同步数值：

spin.valueChanged.connect(slider.setValue) slider.valueChanged.connect(spin.setValue)

这里有一个容易踩的坑：上述两个信号互相连接，当 QSpinBox 的 setValue 触发 valueChanged 后，又会触发 slider 的 setValue，而 slider 的 setValue 又会反触发 spin 的 valueChanged。如果两次设置的值相同，Qt 的信号触发不会丢，但有可能出现无限循环的隐患。稳妥做法是加一个标志位，或者在业务逻辑里判断数值没有变化时直接忽略。

还有一个容易被忽略的细节：QSlider 默认是水平方向，setOrientation(Qt.Vertical)可以变竖。滑块默认可以连续拖动，但在调节音频音量这种场景下，建议设置setPageStep()和setSingleStep()，让键盘控制更加符合直觉。

4.4 用 QFormLayout 快速搭出规范表单

当一个输入面板有多个标签和输入控件时，手工用 QVBoxLayout 一行一行摆布局工作量大且容易错位。QFormLayout 就是为表单设计的：每行左侧放 QLabel，右侧放输入控件，自动右对齐左对齐，处理得妥妥帖帖。

form = QFormLayout() form.addRow("资产名称:", QLineEdit()) form.addRow("数量:", QSpinBox()) form.addRow("分类:", QComboBox())

三行代码就能搭出一个干净的表单。它还能处理“标签长度不一致”的问题，比手工计算列宽可靠得多。这也是我推荐的每一个输入面板的默认起始方案。

5. 容器与导航面板：多页面组织的核心

5.1 QTabWidget 多页签的适用场景

多页面应用最常用的导航形式是页签（Tab）。QTabWidget 管理多个标签页，每个标签页实际上就是一个 QWidget，你可以往里面塞任意布局和组件。

使用 QTabWidget 时我习惯写一个公共方法，把页面创建逻辑封装起来：

self.tabs = QTabWidget() self.tab_assets = self.build_assets_tab() self.tab_monitor = self.build_monitor_tab() self.tabs.addTab(self.tab_assets, "资产台账") self.tabs.addTab(self.tab_monitor, "状态监控")

QTabWidget 默认支持点击标签切换，也支持通过setTabsClosable(True)让每个标签出现关闭按钮。如果页签数量多，可以设置setDocumentMode(True)让页签更扁，风格更像浏览器标签页。我个人经验是：超过五六个页签以后，应优先考虑 QStackedWidget 配合侧边导航。

5.2 QStackedWidget 与侧边导航的配合

QStackedWidget 是一个“堆叠容器”，一次只显示一个子页面，其他页面隐藏。它本身没有导航界面，需要和按钮联动。最常见的做法是做一个侧边栏，点击按钮切换堆叠页面的索引：

self.stack = QStackedWidget() self.stack.addWidget(self.page_dashboard) self.stack.addWidget(self.page_assets) self.stack.addWidget(self.page_settings) nav_button.clicked.connect(lambda: self.stack.setCurrentWidget(self.page_dashboard))

这种“左侧导航＋右侧堆叠页面”的模式，是管理后台类软件的黄金布局。它跟 QTabWidget 最大的区别是：QTabWidget 的标签天然可见，适合页签很少的情况；QStackedWidget 完全由你自己的导航控件控制，适合页面多、需要自定义导航样式的情况。

5.3 QGroupBox、QScrollArea、QSplitter 三兄弟

QGroupBox 是带标题的容器框，它是给一组相关控件“画地盘”的。例如“基本设置”“高级设置”“关于”三个区域，每个区域用 QGroupBox 框起来，视觉上清晰有序。QGroupBox 也支持复选框标题，setCheckable(True)后可以在标题处打勾，实现对整组控件的启用/禁用效果。

QScrollArea 提供滚动区域。凡是嵌套内容超过可视区域的，都应该用 QScrollArea 包一层。需要注意：QScrollArea 不会自动调整内部控件大小，你需要给内部的 QWidget 设置布局，滚动区域才会正常工作。另外强烈建议开启setWidgetResizable(True)，这样当窗口变大时内部内容会自动伸展。

QSplitter 是可拖动分隔条，常用于调整左右两块区域的宽度。举一个真实例子：我把左侧树状导航、右侧表格内容用 QSplitter 分开，用户拖动中间分隔条即可调整两侧比例，体验远超固定布局。QSplitter 内部放 QTreeView 和 QTableView，再配合setStretchFactor()控制初始大小比例，几乎不需要额外代码。

如果你想做一个可折叠的侧边栏，可以通过 QSplitter 加一个按钮来控制setSizes([0, 800])，侧边栏就能平滑折叠。这也是我在“导航面板”里最喜欢用它的原因。

6. 反馈与提示面板：界面需要会“说话”

6.1 进度条、状态标签与工具提示

用户操作界面后，必须收到反馈，否则会怀疑程序是不是卡死了。QProgressBar 是最直接的反馈组件。它有两种模式：确定模式（设置 setRange 和 setValue）和不确定模式（setRange(0,0)），不确定模式适合无法预估进度的场景，比如大量文件扫描。

我习惯把 QProgressBar 放到状态栏里，等耗时任务完成后再隐藏。配合 QThread 使用，为了避免界面上进度条卡顿，进度更新必须通过信号从子线程发到主线程。这里有个重要原则：任何耗时操作都不能阻塞主线程，否则界面会“假死”，QProgressBar 再好看也没用。

QLabel 虽然简单，但它也是反馈面板的重要成员。很多误操作提示、操作结果提示、当前状态文字，我都用 QLabel 放在固定区域直接显示。QLabel 支持setStyleSheet()设置文字颜色和背景色，比如成功提示用绿色，错误提示用红色，一眼辨识度就上来了。工具提示 tooltip 是另外一种轻量反馈：给 QPushButton 设置setToolTip("点击后保存当前配置")，鼠标悬停时显示说明，能极大地减少用户误操作。

6.2 消息框与文件对话框的形式选择

当程序需要跳出特定弹窗时，PySide6 提供了成套的对话框：QMessageBox 用于消息提示和确认，QFileDialog 用于文件选择，QInputDialog 用于简单单行输入。

QMessageBox 是最常用的，它的好处是静态方法一行就能调用：

reply = QMessageBox.question(self, "确认", "确定要删除选中的资产吗？", QMessageBox.Yes | QMessageBox.No) if reply == QMessageBox.Yes: # 执行删除 pass

这里有一个很多人忽略的细节：QMessageBox 一旦弹出来，它是一个模态对话框，会阻塞用户和主窗口的交互。如果你在主线程里调用了 question 这种静态方法，在等待用户点击的过程中，其他界面事件不会被处理。如果你弹出的时机正好在某个事件循环里，有可能会造成假死状态。我的建议是：所有弹窗操作都要在主线程，且弹窗逻辑最好封装成独立的槽函数，避免在循环内部反复弹窗。

文件对话框 QFileDialog 同样有静态方法：

path, _ = QFileDialog.getOpenFileName(self, "选择文件", "", "文本文件 (*.txt);;所有文件 (*)")

它返回文件路径和一个过滤器字符串。使用过滤器;;分隔多个类型，这是 Qt 标准语法。还有一个很容易踩的坑：getSaveFileName不会自动补全扩展名，如果你希望用户选择后自动加上 .log 后缀，需要手动判断并拼接。

7. 绘图与图表面板：数据可视化的两条路

7.1 用 QPainter 实现自定义绘图

当界面需要画曲线、画标记、画自定义组件时，QPainter 是最底层的绘图工具。它能在 QWidget 的 paintEvent 里作画，用法很直接：在 paintEvent 中创建 QPainter 对象，指定画笔 QPen、画刷 QBrush，然后 drawLine、drawRect、drawText。

def paintEvent(self, event): painter = QPainter(self) pen = QPen(Qt.blue, 2) painter.setPen(pen) painter.drawLine(10, 10, 100, 100) painter.drawText(120, 46, "开始绘制") painter.end()

注意结束时要调用painter.end()或者手动释放，否则会留下未释放的系统资源。每次窗口 resize 或 update 时，paintEvent 重放，这保证了绘制内容能跟随窗口状态改变。但正是因为重绘机制，绘图逻辑必须快，不能在 paintEvent 里做耗时的数据运算，否则界面重绘时就会卡顿。

QPainter 适合绘制形状固定的图形，比如波形图、仪表盘、自定义按钮背景。但如果你想要坐标轴、网格、缩放、拖拽这些交互功能，自己写会很痛苦，这时应该换 QChart。

7.2 用 QChart 快速搭建可交互图表

QChart 是 Qt Charts 模块的图表框架，支持折线图、柱状图、饼图、散点图等常见图表类型。它自带坐标轴、图例、可缩放和拖拽的交互能力。PySide6 中需要先导入from PySide6.QtCharts import QChart, QChartView, QLineSeries。

基本使用方式分三步：创建序列，添加数据点，设置到 QChart 并放到 QChartView 中：

series = QLineSeries() series.append(0, 6) series.append(1, 8) series.append(2, 12) chart = QChart() chart.addSeries(series) chart.createDefaultAxes() chart.legend().hide() chart_view = QChartView(chart) layout.addWidget(chart_view)

QChartView 默认支持鼠标缩放和平移，也可以通过chart_view.setRubberBand(QChartView.RectangleRubberBand)让用户拖出一个矩形区域进行局部缩放。这个交互特性在监控类界面里非常实用，用户能随时放大查看某段数据的细节。

7.3 性能细节：大数据曲线与 QGraphicsView

当数据点数量到达五万以上，QLineSeries 直接画就会有点吃紧。解决路径有两个：一是对数据做降采样，只绘制可视范围内的点；二是使用 QGraphicsView + QGraphicsPathItem 自己管理，这能获得更高的渲染性能。针对第一个方案，Qt 自带QLineSeries的 append 方法逐点添加效率不高，更高效的方式是传入 QList 或 QPointF 数组批量设置。

QGraphicsView 是比 QPainter 更高一层的场景图框架，适合承载大量图形元素。比如做一个地图编辑器、流程图编辑器、类图工具，你会发现在 QGraphicsView 里管理几百个图形对象比在 QPainter 里手动画要省心太多。它支持图元间的鼠标事件、碰撞检测、层级变换，基本上“可交互画布”的需求都是它的专长。

8. 常见问题与排查技巧实录

8.1 表格大数据卡顿：一次真实的迁移记录

我去年做一个资产管理系统，用 QTableWidget 加载了两万行数据，内存占用直接涨了两三百兆，滚动一下要等一秒多。排查的时候用性能分析器看了一下，八成时间都耗在 QTableWidgetItem 的创建和释放上。后来替换成 QTableView + QAbstractTableModel，数据还是那些数据，滚动瞬间变得跟剪贴板一样顺滑。

这次迁移里最深的体会是：不要试图优化 QTableWidget，直接换架构。迁移过程中踩了的坑包括：QTableView 默认没有网格线，需要setShowGrid；默认表头不接受排序，需要重写sort()；编辑功能默认关闭，需要设置setEditTriggers和 Model 的setData()。这些细节不复杂，但一开始如果没规划好，二次返工的时间比一开始就选 QTableView 多得多。

8.2 启动时报错：Qt 平台插件找不到次对法

新手最容易碰到的启动崩溃提示长这样：

qt.qpa.plugin: could not find the Qt platform plugin "windows" in ""

这个报错的原因通常是 PySide6 的 plugins 目录没有被正确加载，常见于打包后的 exe 或隔离环境。解决办法：第一检查 PySide6 是否完整安装，第二在代码开头强制指定插件路径：

import PySide6 import os os.environ["QT_QPA_PLATFORM_PLUGIN_PATH"] = os.path.join( os.path.dirname(PySide6.__file__), "plugins", "platforms" )

如果你用了 PyInstaller 打包，还需要在 spec 文件里显式添加 PySide6 的插件目录作为数据文件。这个问题几乎每个人都会遇到一次，知道原理以后每次都能秒修。

8.3 界面交互小技巧三则

这里分享三个我项目中反复使用的小技巧。

第一个是获取窗体的属性值。如果你弹出了一个子窗口，希望在主窗口关闭子窗口后拿到它的输入值，可以监听子窗体的finished信号，然后在槽函数里通过self.child_window.get_value()读取。不要在窗口 close 之后再去读取，因为部分控件在窗口销毁后访问会崩溃。

第二个是实现列表拖拽排序。QListView 开启setDragDropMode(QAbstractItemView.InternalMove)，配合 QListWidget 就能直接拖拽改变顺序。如果是自定义 Model，还需要实现moveRows或dropMimeData方法，这个稍微复杂，但效果是“原生”级别的。

第三个是模拟鼠标点击事件。用 QTest 模块可以很方便地实现自动化测试：

from PySide6.QtTest import QTest QTest.mouseClick(button, Qt.LeftButton)

在做自动化自测或演示脚本时，这一行代码比手动模拟 move/click 事件省力得多。

8.4 我常用的 PySide6 调试与打包备忘

写 PySide6 项目时，我习惯在入口处加 Qt 的调试环境变量：QT_DEBUG_PLUGINS=1可以打印插件搜索路径，定位 loading 问题；QT_LOGGING_RULES="qt.qpa.*=true"可以打印窗口系统相关日志。调试 UI 布局时，开启QWidget.setAttribute(Qt.WA_StyledBackground)配合背景色，能快速看到每个部件的实际边界。

打包发布时，推荐 Nuitka 搭配 PyInstaller 使用。Nuitka 在 Python 代码编译上有明显优势，启动速度更快，体积更小；PyInstaller 则胜在打包流程成熟，插件收集会完整一些。实测下来，小工具用 PyInstaller，偏大项目用 Nuitka，各有千秋。打包之后一定要在目标机器上重跑一遍，环境差异会暴露一堆本机永远遇不到的问题。

最后再聊一句个人心得。按面板拆组件这套方法，真正磨利的是对界面结构的判断力。接触一个软件需求时，你能快速把它拆成“窗口框架、数据区域、输入区域、导航方式、反馈方式、可视化需求”六块，选型、估时、排人手都会踏实很多。这套思路不止适合 PySide6，换成 Qt 的 C++ 开发、或者哪怕用其他 GUI 框架，也同样复用。每个面板的选型其实都有约定俗成的最优解，剩下要做的就是写代码、调样式、做测试了。