1. 从一个实际需求说起为什么单元格字体设置值得单独拿出来讲做桌面端工具开发的朋友大概率都碰过这样一个场景用 PyQt5 搭了一个数据展示界面QTableWidget 里塞满了从数据库或者 Excel 读进来的数据行列对齐、排序、筛选都跑通了结果产品或者自己一看所有单元格字体一模一样重点数据完全淹没在密密麻麻的表格里。这时候你想给某些单元格加粗、标红、换字号让关键信息跳出来结果一查文档发现 QTableWidgetItem 的 setFont 好像能用但实际写进去要么不生效要么整列都变了要么改完一刷新又回去了。这个需求看起来小但它是表格类桌面应用从“能用”到“好用”的分水岭。QTableWidget 作为 PyQt5 里最常用的表格控件之一单元格字体控制涉及 QTableWidgetItem、QFont、样式表、委托绘制好几条技术路线每条路线的适用场景和坑都不一样。我见过不少项目在这块反复返工最后干脆放弃精细控制所有单元格统一字体了事。这篇文章面向的是已经能用 PyQt5 把表格跑起来、但想在视觉呈现上再进一步的开发者。不管你是刚接触 Qt 桌面开发的新手还是写过几个工具想优化交互体验的老手下面这些内容都能直接拿去用。我会把 QTableWidget 单元格字体设置的几条主流方案拆开讲清楚包括它们各自的原理、代码怎么写、什么时候该用哪条路以及我在实际项目里踩过的那些坑。核心关键词就一个QTableWidget 单元格字体设置。围绕它我们把 QTableWidgetItem 的字体接口、QFont 的构造与属性、样式表的边界、以及自定义委托的进阶玩法全部串一遍。2. 先搞清楚 QTableWidget 的渲染机制不然改字体全靠猜2.1 单元格内容到底是谁在画很多人第一次用 QTableWidget会下意识觉得“单元格”是一个独立的控件就像 QLabel 一样我拿到它设置字体就行了。实际上 QTableWidget 的单元格并不是 QWidget它没有独立的控件实体。表格里你看到的每一个格子都是 QTableWidget 自己在 paintEvent 里画出来的画的时候会去问对应的 QTableWidgetItem你的文本是什么、你的字体是什么、你的前景色背景色是什么、对齐方式是什么。QTableWidgetItem 本质上是一个数据容器它继承自 QTableWidgetItem 的基类负责存储显示数据、字体、颜色、图标、对齐、复选框状态等属性。当 QTableWidget 需要绘制某个单元格时它会调用 item 的 font() 方法拿到 QFont然后用这个字体去绘制文本。所以设置单元格字体的第一反应就是拿到 item调用 setFont。这个机制决定了几个关键点。第一如果你没有为某个单元格创建 QTableWidgetItem那这个格子就是空的谈不上字体设置。第二item 的字体是独立存储的你改了一个 item 的字体不会影响其他 item。第三QTableWidget 本身也有一个 font 属性那是整个控件的默认字体item 如果没有单独设置字体就会继承控件的字体。理解这三层关系后面很多“为什么不生效”的问题就迎刃而解了。2.2 QFont 对象字体设置的载体QFont 是 Qt 里描述字体的类它包含字体族、字号、粗细、斜体、下划线、删除线、字间距等属性。设置单元格字体本质上就是构造一个 QFont 对象配置好你想要的属性然后通过 item.setFont() 塞进去。QFont 的构造方式很灵活常见的有几种from PyQt5.QtGui import QFont # 方式一只指定字体族 font1 QFont(Microsoft YaHei) # 方式二指定字体族和字号单位是 pt font2 QFont(Microsoft YaHei, 12) # 方式三指定字体族、字号、粗细 font3 QFont(Microsoft YaHei, 12, QFont.Bold) # 方式四先构造再逐个设置属性 font4 QFont() font4.setFamily(Microsoft YaHei) font4.setPointSize(12) font4.setBold(True) font4.setItalic(False)这里有个细节值得注意QFont 的字号单位默认是 point磅不是像素。如果你习惯用像素思维可能会觉得 12 太小实际上 12pt 在常规 DPI 下大约相当于 16px视觉上已经比较合适了。如果你确实想用像素单位可以调用 setPixelSize()但要注意在高 DPI 屏幕上像素单位的缩放行为可能和预期不一致点值单位通常更稳妥。另外QFont 的粗细除了用 QFont.Bold 这种枚举还可以用 setWeight() 传入 0 到 99 的数值Qt5 里 QFont.Bold 对应的是 75。不过实际使用中直接用枚举可读性更好除非你需要精细控制字重。2.3 默认字体从哪来优先级怎么排一个单元格最终显示出来的字体是经过优先级叠加的。优先级从低到高大致是这样的应用程序全局字体QApplication.setFontQTableWidget 控件自身的字体tableWidget.setFontQTableWidgetItem 的字体item.setFont样式表中针对 QTableWidget::item 的 font 属性如果写了的话也就是说item 级别的设置会覆盖控件级别的设置。这个优先级链条解释了一个常见困惑为什么我给表格设置了字体但某些单元格还是原来的样子因为那些单元格的 item 单独设置过字体控件级别的设置对它们无效。还有一个容易被忽略的点如果你在 QTableWidget 上用了 setStyleSheet 并且写了 font 相关属性样式表的优先级在某些情况下会覆盖 item 的设置。这个行为在不同 Qt 版本里表现不完全一致所以我的建议是字体设置尽量走 item.setFont 这条路样式表只用来管边框、背景、选中态这些避免两套机制打架。3. 基础操作用 setFont 给单元格换字体3.1 最小可用示例先看一个最直接的例子。假设我们有一个 3 行 3 列的表格想把第一行第一列的字体改成加粗的微软雅黑 14 号from PyQt5.QtWidgets import QApplication, QTableWidget, QTableWidgetItem from PyQt5.QtGui import QFont import sys app QApplication(sys.argv) table QTableWidget(3, 3) table.setHorizontalHeaderLabels([名称, 数值, 状态]) # 填充数据 for row in range(3): for col in range(3): item QTableWidgetItem(f数据{row}-{col}) table.setItem(row, col, item) # 给第一行第一列设置字体 target_item table.item(0, 0) font QFont(Microsoft YaHei, 14, QFont.Bold) target_item.setFont(font) table.show() sys.exit(app.exec_())这段代码跑起来第一行第一列的“数据0-0”就会明显比其他单元格粗且大。关键点在于 table.item(0, 0) 返回的是 QTableWidgetItem 对象如果那个位置没有设置过 item返回的是 None直接调用 setFont 会报 AttributeError。所以实际操作中要么先确保 item 已经创建要么加个判空。3.2 批量设置时的性能考量如果表格只有几十行逐个 item.setFont 完全没问题。但如果表格有几千行甚至上万行每个单元格都单独构造一个 QFont 对象再设置会有明显的性能开销。我实测过一个 5000 行 10 列的表格逐单元格 new QFont 并 setFont界面卡顿了将近两秒。优化的思路很简单复用 QFont 对象。如果你有几种固定的字体样式比如“正常”“加粗”“警告红”那就预先构造好这几个 QFont 实例批量设置的时候直接复用不要在每个循环里重新构造。# 预构造字体对象 font_normal QFont(Microsoft YaHei, 10) font_bold QFont(Microsoft YaHei, 10, QFont.Bold) font_warning QFont(Microsoft YaHei, 10) font_warning.setBold(True) # 批量设置时复用 for row in range(table.rowCount()): for col in range(table.columnCount()): item table.item(row, col) if item is None: continue if some_condition(row, col): item.setFont(font_bold) else: item.setFont(font_normal)这里还有一个更隐蔽的性能点每次 setFont 都会触发 item 的数据变更信号进而可能触发视图重绘。如果你在循环里逐个设置视图可能会重绘多次。更高效的做法是设置之前先调用 table.setUpdatesEnabled(False)设置完再 table.setUpdatesEnabled(True)这样中间过程不会触发重绘。提示setUpdatesEnabled(False) 期间表格不会刷新设置完成后记得恢复为 True否则界面看起来像卡死了。3.3 字体设置与数据角色的关系QTableWidgetItem 支持多种数据角色比如 DisplayRole 存显示文本FontRole 存字体ForegroundRole 存前景色。setFont 本质上就是设置了 FontRole 的数据。你也可以通过 setData(Qt.FontRole, font) 达到同样效果两者是等价的。from PyQt5.QtCore import Qt item.setData(Qt.FontRole, font) # 等价于 item.setFont(font)理解这一点有什么用呢当你需要做自定义委托绘制时委托的 paint 方法里可以通过 index.data(Qt.FontRole) 拿到字体这样你的绘制逻辑就能和 item 的设置保持一致。如果你用 setFont 设置委托里用 FontRole 取是能取到的不用担心两套机制不通。4. 进阶玩法不同场景下的字体控制策略4.1 按条件动态设置字体数据驱动的视觉分层实际项目里字体设置很少是静态的更多是根据数据内容动态决定。比如一个监控面板数值超过阈值就加粗标红正常就普通显示。这种场景下字体设置逻辑通常放在数据填充的函数里边填数据边判断。def fill_table(table, data_list): font_normal QFont(Microsoft YaHei, 10) font_alert QFont(Microsoft YaHei, 10, QFont.Bold) table.setRowCount(len(data_list)) for row, record in enumerate(data_list): name_item QTableWidgetItem(record[name]) value_item QTableWidgetItem(str(record[value])) if record[value] 100: value_item.setFont(font_alert) value_item.setForeground(QColor(#D32F2F)) else: value_item.setFont(font_normal) table.setItem(row, 0, name_item) table.setItem(row, 1, value_item)这种写法的好处是逻辑集中数据进来的时候视觉属性一并确定后续不需要再遍历表格去改。缺点是如果阈值会动态变化比如用户拖动滑块调整告警线就需要重新遍历所有行更新字体这时候建议把字体更新逻辑单独抽成一个函数数据变化时调用。4.2 整行整列的字体统一设置有时候需求是整列加粗比如表头列或者汇总列。这时候逐个 item 设置虽然可行但代码啰嗦。可以封装一个辅助函数def set_column_font(table, col, font): for row in range(table.rowCount()): item table.item(row, col) if item is not None: item.setFont(font) def set_row_font(table, row, font): for col in range(table.columnCount()): item table.item(row, col) if item is not None: item.setFont(font)注意表头horizontalHeader的字体不归 QTableWidgetItem 管要用 table.horizontalHeader().setFont(font) 来设置。垂直表头同理用 verticalHeader().setFont()。这两个容易和单元格字体混淆实际项目中经常有人改了单元格字体发现表头没变就是漏了这一步。4.3 用样式表控制字体的边界与陷阱QTableWidget 支持 Qt 样式表你可以写这样的规则QTableWidget::item { font-family: Microsoft YaHei; font-size: 12pt; }但这里有几个坑必须说清楚。第一样式表里的 font-size 单位如果写 pt 和 px渲染效果可能和 QFont 的 pointSize 不完全一致。第二样式表设置的是所有 item 的默认字体它和 item.setFont 的优先级关系在不同 Qt 版本里有差异有的版本样式表会覆盖 item 设置有的不会。第三样式表不支持按条件动态改变字体你没法在样式表里写“如果数值大于100就加粗”。所以我的经验是样式表用来管那些统一的、静态的视觉属性比如边框、背景、选中颜色、表头样式字体这种需要精细控制、动态变化的东西老老实实用 item.setFont。两套机制各管一摊不要交叉能省掉大量调试时间。4.4 自定义委托当 setFont 不够用的时候绝大多数场景下 item.setFont 已经够用了。但有些特殊需求它搞不定比如同一个单元格里部分文字加粗、部分文字正常富文本效果字体大小根据单元格宽度自适应绘制时动态计算字体比如根据数值大小连续变化字号这些场景就需要上 QStyledItemDelegate重写 paint 方法自己控制绘制过程。下面是一个简单示例让单元格文本根据内容长度自动缩小字号from PyQt5.QtWidgets import QStyledItemDelegate, QStyle from PyQt5.QtGui import QFont, QFontMetrics class AutoShrinkDelegate(QStyledItemDelegate): def paint(self, painter, option, index): text index.data(Qt.DisplayRole) if text: font QFont(Microsoft YaHei, 10) metrics QFontMetrics(font) available_width option.rect.width() - 8 while metrics.horizontalAdvance(text) available_width and font.pointSize() 6: font.setPointSize(font.pointSize() - 1) metrics QFontMetrics(font) painter.save() painter.setFont(font) painter.drawText(option.rect, Qt.AlignCenter, text) painter.restore() else: super().paint(painter, option, index)然后把委托应用到表格上delegate AutoShrinkDelegate() table.setItemDelegate(delegate)用了自定义委托之后item.setFont 设置的字体在绘制时会被委托覆盖掉因为绘制逻辑完全由委托接管了。这一点要特别注意委托和 item.setFont 不要同时用在同一列上否则你会困惑为什么字体设置不生效。如果只有某几列需要特殊绘制可以用 setItemDelegateForColumn(col, delegate) 只对特定列生效其他列继续走默认绘制和 item.setFont。注意自定义委托的 paint 方法里一定要调用 painter.save() 和 painter.restore()否则你对 painter 的字体、颜色修改会泄漏到后续单元格的绘制中导致整个表格显示混乱。这个坑我踩过排查了半天才发现是 painter 状态没恢复。5. 实操全流程一个完整的表格字体控制案例5.1 需求描述与界面规划假设我们要做一个简易的服务器状态监控面板表格显示每台服务器的名称、CPU 使用率、内存使用率、状态。视觉要求表头加粗字号比正文大一号服务器名称列正常显示CPU 和内存使用率超过 80% 时数值加粗并标红状态列为“异常”时整行字体加粗表格整体使用微软雅黑正文 10pt这个需求覆盖了静态字体、条件字体、整行字体、表头字体几个典型场景很适合作为完整案例。5.2 完整代码实现import sys from PyQt5.QtWidgets import (QApplication, QTableWidget, QTableWidgetItem, QMainWindow, QVBoxLayout, QWidget) from PyQt5.QtGui import QFont, QColor from PyQt5.QtCore import Qt class MonitorPanel(QMainWindow): def __init__(self): super().__init__() self.setWindowTitle(服务器状态监控) self.resize(800, 500) central QWidget() self.setCentralWidget(central) layout QVBoxLayout(central) self.table QTableWidget() layout.addWidget(self.table) self.init_table() self.load_data() def init_table(self): headers [服务器名称, CPU使用率, 内存使用率, 状态] self.table.setColumnCount(len(headers)) self.table.setHorizontalHeaderLabels(headers) # 表头字体加粗比正文大一号 header_font QFont(Microsoft YaHei, 11, QFont.Bold) self.table.horizontalHeader().setFont(header_font) # 表格控件默认字体 base_font QFont(Microsoft YaHei, 10) self.table.setFont(base_font) # 列宽自适应 self.table.horizontalHeader().setStretchLastSection(True) def load_data(self): # 模拟数据 servers [ {name: 节点A, cpu: 45, mem: 62, status: 正常}, {name: 节点B, cpu: 88, mem: 91, status: 异常}, {name: 节点C, cpu: 23, mem: 35, status: 正常}, {name: 节点D, cpu: 92, mem: 78, status: 异常}, {name: 节点E, cpu: 67, mem: 55, status: 正常}, ] # 预构造字体对象避免循环内重复创建 font_normal QFont(Microsoft YaHei, 10) font_alert QFont(Microsoft YaHei, 10, QFont.Bold) font_row_alert QFont(Microsoft YaHei, 10, QFont.Bold) color_alert QColor(#D32F2F) self.table.setRowCount(len(servers)) self.table.setUpdatesEnabled(False) # 暂停刷新提升批量设置性能 for row, srv in enumerate(servers): is_abnormal srv[status] 异常 # 名称列 name_item QTableWidgetItem(srv[name]) if is_abnormal: name_item.setFont(font_row_alert) self.table.setItem(row, 0, name_item) # CPU列 cpu_item QTableWidgetItem(f{srv[cpu]}%) if srv[cpu] 80: cpu_item.setFont(font_alert) cpu_item.setForeground(color_alert) else: cpu_item.setFont(font_normal) cpu_item.setTextAlignment(Qt.AlignCenter) self.table.setItem(row, 1, cpu_item) # 内存列 mem_item QTableWidgetItem(f{srv[mem]}%) if srv[mem] 80: mem_item.setFont(font_alert) mem_item.setForeground(color_alert) else: mem_item.setFont(font_normal) mem_item.setTextAlignment(Qt.AlignCenter) self.table.setItem(row, 2, mem_item) # 状态列 status_item QTableWidgetItem(srv[status]) if is_abnormal: status_item.setFont(font_row_alert) status_item.setForeground(color_alert) else: status_item.setFont(font_normal) status_item.setTextAlignment(Qt.AlignCenter) self.table.setItem(row, 3, status_item) self.table.setUpdatesEnabled(True) # 恢复刷新 if __name__ __main__: app QApplication(sys.argv) window MonitorPanel() window.show() sys.exit(app.exec_())5.3 关键步骤拆解与参数说明这段代码里有几个设计决策值得展开说。表头字体单独设置。表头不是 QTableWidgetItem它由 QHeaderView 管理所以要用 horizontalHeader().setFont()。字号选了 11pt比正文的 10pt 大一号加粗。这个搭配在 1080p 屏幕上视觉层次清晰不会太夸张。字体对象预构造。font_normal、font_alert、font_row_alert 在循环外创建循环内复用。虽然这个例子里只有 5 行数据性能差异可以忽略但养成这个习惯等表格变成 5000 行的时候就能省下可观的构造开销。QFont 的构造涉及字体族查找和属性初始化不是零成本的。setUpdatesEnabled 包裹批量操作。在 setRowCount 之后、数据填充之前关闭刷新填充完成后恢复。这样整个填充过程只触发一次重绘而不是每设置一个 item 就重绘一次。对于大数据量表格这个优化能把加载时间缩短一半以上。颜色和字体配合使用。超过阈值的数值不仅加粗还标红。字体负责“突出”颜色负责“警示”两者配合比单独用其中一个效果更好。颜色用的是 #D32F2F一个偏深的红色在白底上对比度足够又不像纯红那么刺眼。对齐方式的处理。数值列和状态列用了 AlignCenter名称列保持默认左对齐。对齐方式通过 setTextAlignment 设置和字体是独立的属性互不影响。5.4 效果验证与调试方法代码跑起来之后怎么确认字体设置真的生效了最直接的方法是肉眼观察但有些细微差异比如 10pt 和 11pt 的区别在低分辨率屏幕上可能不明显。更可靠的验证方式是在代码里打印 item.font().pointSize() 和 item.font().bold()确认属性确实写进去了。如果发现某个单元格字体没变按这个顺序排查确认 item 不是 Noneitem 确实被 setItem 放进了表格确认 setFont 在 setItem 之前或之后调用都行但要在 item 被添加到表格之后检查确认没有样式表覆盖如果表格设置了 setStyleSheet 且包含 font 规则先注释掉试试确认没有自定义委托接管了绘制如果有检查委托的 paint 方法确认表格的 setFont 没有在 item.setFont 之后又被调用控件级设置不会覆盖 item 级设置但如果你重新创建了 item之前的设置就丢了6. 常见问题与排查技巧实录6.1 字体设置不生效的六种原因这个问题是 QTableWidget 字体设置里出现频率最高的。我把实际项目中遇到过的原因整理成了一张排查表现象可能原因排查方法解决方案所有单元格字体都没变设置的是 table.setFont 但 item 有独立字体检查 item.font() 是否与预期一致改为逐个 item.setFont部分单元格字体没变那些 item 是 None 或未创建打印 table.item(row, col)先创建 item 再设置字体设置后刷新又恢复数据重新加载时重建了 item检查数据加载逻辑在重建 item 时重新应用字体样式表写了 font 但无效样式表语法错误或优先级问题用 Qt Designer 预览样式表改用 item.setFont自定义委托后字体失效委托 paint 覆盖了绘制检查是否设置了 itemDelegate在委托中读取 FontRole高 DPI 屏幕上字体模糊像素单位与缩放不匹配对比 pt 和 px 设置统一使用 pointSize这张表里的每一行都是我或身边同事真实踩过的坑。其中“数据重新加载时重建 item”这一条特别隐蔽因为代码逻辑看起来没问题——加载数据、创建 item、设置字体但如果你在加载前调用了 table.clear() 或者 setRowCount(0)所有 item 都被销毁了之前设置的字体自然也没了。解决办法是在数据加载函数里统一应用字体而不是在初始化时设置一次就完事。6.2 字体族名称写错导致的静默失败QFont 的字体族名称如果写错了Qt 不会报错它会静默回退到系统默认字体。比如你写 QFont(Microsoft YaHei) 在 Windows 上没问题但到了 Linux 或者 macOS 上这个字体不存在就会回退。更隐蔽的是拼写错误比如写成 MicroSoft YaHei大小写不对或者 微软雅黑中文名在某些系统上不识别都会导致字体设置看起来“没生效”。我的做法是优先使用字体的英文名并且在程序启动时检查字体是否可用。QFontDatabase 提供了 families() 方法可以列出系统所有可用字体族from PyQt5.QtGui import QFontDatabase available QFontDatabase().families() if Microsoft YaHei in available: font QFont(Microsoft YaHei, 10) else: font QFont(Sans Serif, 10) # 回退方案如果项目需要跨平台更稳妥的做法是准备一个字体族候选列表按优先级依次尝试取第一个可用的。这样在 Windows 上用微软雅黑在 macOS 上用苹方在 Linux 上用 Noto Sans各平台都能有不错的显示效果。6.3 字号设置的常见误区字号这块有几个高频误区。第一个是 pt 和 px 混用前面提过了QFont 默认用 ptsetPixelSize 用 px两者不要混着设否则同一个表格里不同单元格的视觉大小可能不一致。第二个是忽略了系统 DPI 缩放在 125% 或 150% 缩放的屏幕上同样的 pt 值显示出来会比 100% 缩放时大如果你硬编码了像素级的布局尺寸可能会发现字体把单元格撑破了。第三个是字号设得太大导致文本被截断QTableWidget 默认不会自动缩小字体来适应单元格宽度超出部分会显示省略号或者直接裁掉。对于第三个问题解决办法要么是手动调整列宽table.resizeColumnsToContents()要么是用前面提到的自定义委托做自动缩放。resizeColumnsToContents 简单粗暴但列很多的时候会让表格变得很宽需要配合水平滚动条使用。6.4 性能问题的排查与优化表格数据量大时字体设置可能成为性能瓶颈。我总结了一个简单的排查流程先确认卡顿发生在哪个阶段。是在 setRowCount 的时候还是在循环 setItem 的时候还是在 setFont 的时候可以用 QTime 或者 Python 的 time 模块打点计时。import time t0 time.time() # 批量设置字体 for row in range(table.rowCount()): for col in range(table.columnCount()): item table.item(row, col) if item: item.setFont(font) t1 time.time() print(f字体设置耗时: {t1 - t0:.3f}秒)如果确认是字体设置慢优化手段按优先级排序用 setUpdatesEnabled(False) 包裹批量操作预构造 QFont 对象避免循环内重复创建只对需要特殊字体的单元格设置不需要的保持默认如果数据量极大十万行以上考虑用 QTableView 自定义模型替代 QTableWidget模型可以按需提供 FontRole 数据不需要为每个单元格创建 item提示QTableWidget 适合中小数据量几千行以内的场景数据量再大建议换 QTableView QAbstractTableModel性能和内存占用都会好很多。字体设置在这种架构下通过模型的 data() 方法返回 FontRole 来实现思路和 item.setFont 一致只是数据来源从 item 变成了模型。7. 几个容易被忽略的细节与个人经验7.1 排序后字体跟着走吗QTableWidget 开启排序后table.setSortingEnabled(True)用户点击表头会触发排序。排序的本质是交换 item 的位置item 本身携带的字体属性会跟着 item 一起移动。所以如果你给“节点B”这一行设置了加粗排序后“节点B”跑到别的位置加粗效果依然跟着它。这个行为通常是符合预期的但如果你希望字体和行号绑定而不是和数据绑定那就需要在排序信号触发后重新应用字体。7.2 复制粘贴时的字体丢失QTableWidget 默认支持选中单元格后 CtrlC 复制但复制出去的是纯文本字体信息不会带过去。如果你需要连格式一起复制得自己实现剪贴板逻辑把 HTML 格式的富文本写进 QClipboard。这个需求在报表类工具里比较常见实现起来不算复杂但要注意 HTML 里的字体样式要和表格里看到的一致。7.3 编辑状态下的字体表现单元格进入编辑状态时QTableWidget 会弹出一个 QLineEdit 编辑器这个编辑器的字体默认继承自 item 的字体。但如果你用了自定义委托的 createEditor就需要在创建编辑器时手动把字体设置上去否则编辑时看到的是默认字体和显示状态不一致体验很割裂。def createEditor(self, parent, option, index): editor super().createEditor(parent, option, index) font index.data(Qt.FontRole) if font: editor.setFont(font) return editor7.4 深浅色主题切换时的字体适配现在很多应用支持深色模式表格背景变深了字体颜色要跟着变但字体本身族、字号、粗细通常不需要变。不过有一个例外细体字在深色背景上看起来会比在浅色背景上更细如果条件允许深色模式下可以适当增加字重或者换用稍大一号的字号视觉平衡会更好。这个属于细节优化不是必须的但做了之后用户能感觉到“这个工具很精致”。7.5 我个人的一条核心经验折腾了这么多项目之后我最大的体会是表格字体控制要尽早规划不要等到界面堆了几十个控件才回头补。在项目初期就确定好字体方案——用哪几个字体族、几档字号、哪些场景加粗、哪些场景变色——然后封装成统一的辅助函数或者样式常量。后面不管加多少列、多少行字体设置都是调用现成的函数不会散落在各处。我见过太多项目字体设置代码散在十几个文件里有的用 item.setFont有的用样式表有的在委托里硬编码最后想统一调整一下正文字号得改十几个地方还容易漏。这种技术债在项目初期花半小时规划就能避免后期可能要花好几天来还。另外QFont 对象是可以共享的但要注意 QFont 是隐式共享的copy-on-write你把一个 QFont 赋给多个 item它们共享同一份数据直到某个 item 修改了字体属性才会触发深拷贝。所以预构造字体对象复用是完全安全的不用担心改了一个 item 的字体影响其他 item。这个机制 Qt 已经处理好了放心用就行。