字体这事儿说大不大说小不小。做Qt界面开发的十有八九都在QFont上吃过亏——要么中文显示成方块要么高分屏下控件挤成一团要么DPI一变化整个界面直接没法看。问题看起来五花八门其实根子往往都落在同一个类上QFont。这个类表面上就是“设置一个字体”但内部牵扯到字体匹配、回退、渲染、度量、DPI换算一大堆机制不把这些搞清楚界面迟早给你颜色看。这篇就专注把QFont从里到外拆一遍。我会结合自己实际项目里踩过的坑和验证过的做法讲清楚它的构造方式、属性含义、字体度量、匹配回退逻辑以及在布局、高分屏、动态调整场景下的正确用法。文章面向的是正在用Qt做界面、想系统搞定字体问题的开发者不管你是刚入门还是已经写了两三年界面这里都有你能直接拿去用的东西。1. 先把QFont的几个底层机制弄明白1.1 构造函数和隐式共享为什么赋值这么“便宜”QFont算是Qt里典型的隐式共享类跟QString、QImage一个路数。你写下面这种代码QFont font1(Arial, 12); QFont font2 font1; font2.setBold(true);font2修改之前font1和font2底层共享同一份字体数据拷贝几乎零成本。一旦调了setBold内部触发写时复制才真正分出两套数据。这个机制的好处是你在界面里到处传QFont、存QFont都不用心疼性能它本质上是个轻量句柄。构造这块有两个高频写法强烈建议养成固定习惯QFont font1(Microsoft YaHei, 9); // 指定字体族 点阵大小 QFont font2; font2.setFamily(Microsoft YaHei); font2.setPointSize(9);第二种可读性更好尤其在需要动态修改多个属性时比构造函数一串参数清楚得多。类似的还有QFont(const QStringList families, int pointSize)这个重载传一个候选字体族列表进去Qt会按顺序尝试匹配第一个能找到的就生效找不到就往下走。这个对跨平台发布软件特别有用后面讲字体匹配时再细说。1.2 pointSize和pixelSize这个坑我见人踩过无数次QFont里有两个大小属性含义完全不同pointSize以“点”为单位。1点1/72英寸。在Qt里它跟屏幕DPI绑定同一个pointSize在96 DPI和120 DPI下实际像素尺寸不一样。pixelSize以物理像素为单位不随DPI变化。很多新手直接用setPointSize(12)在高分屏的Windows笔记本上字体显得特别小因为Qt拿到的是系统缩放后的逻辑DPI字体像素尺寸没有跟着放大。反过来有人为了字体大小统一用setPixelSize(16)结果在低DPI机器上字体偏大在高DPI上又不够大。实际项目里我的做法是能用pointSize就用pointSize同时开Qt的DPI缩放支持Qt 5.6设置Qt::AA_EnableHighDpiScalingQt 6默认开启让系统帮我们做换算。只有涉及自绘控件、导出图片这种需要精确像素对齐的场景才改用pixelSize。1.3 字重、斜体和下划线不只有boldQFont::setWeight接受的是一个0到99的整数标准值定义在QFont::Weight枚举里枚举值数值俗称Thin0极细Light25细体Normal50常规Medium57中等DemiBold63半粗Bold75粗体Black87特粗问题在于不是所有字体族都提供全套字重。微软雅黑有Light、Regular、Bold但你要设DemiBold系统匹配不上就自动回退到Regular或Bold。你设置的Weight只是一个请求值实际渲染字体由QFontInfo告诉你。如果你特别在意某个字重最好先用QFontDatabase确认字体族支持哪些字重再去做精确设置。setItalic和setUnderline相对简单一眼就懂但有个细节容易忽略setItalic(true)在某些字体族上会触发合成斜体而不是使用字体自带的斜体字形效果会有细微差异。做阅读类应用时要留意这一点。2. 字体度量布局不崩的秘密武器2.1 QFontMetrics到底量的是什么QFont只负责“描述一个字体请求”真正要拿字体去排版得靠度量类。最常用的是QFontMetrics整数精度和QFontMetricsF浮点精度前者用于屏幕绘制后者用于打印和精确排版。最关键的几个度量值QFont font(Microsoft YaHei, 9); QFontMetrics fm(font); int height fm.height(); // 行高ascent descent int ascent fm.ascent(); // 基线以上高度 int descent fm.descent(); // 基线以下高度 int lineSpacing fm.lineSpacing(); // 实际行距一般等于 height leading int leading fm.leading(); // 行距调节值 int averageCharWidth fm.averageCharWidth(); // 平均字符宽度拿height和lineSpacing举例如果你用固定行高的列表控件比如QListView的uniformItemSizes行高至少得取fm.lineSpacing()再加一点余量否则中文的拼音注音、上下标字符都会被裁掉。我习惯加2-3像素的padding视觉效果更宽松。2.2 文本宽度计算elide和换行的底层依赖fm.horizontalAdvance(const QString text)返回的是整段字符串的像素宽度这是个高频调用。按钮、标签、表格列头要做“文本超出显示省略号”的效果就是靠它先量出宽度再用fm.elidedText(text, Qt::ElideRight, maxWidth)得到截断后的字符串。这里有个性能陷阱horizontalAdvance在循环里频繁调用很贵尤其是QSS里大量使用富文本或代理里反复计算时。我见过一个列表代理每行数据变化都会调用几十次horizontalAdvance肉眼可见卡顿。优化手段要么缓存计算结果要么改用QFontMetricsF减少精度转换开销要么批量测量。换行也是一样QTextLayout做文字排版时内部会用字体度量来断行。自己写文本换行逻辑时千万别用text.length() * averageCharWidth这种粗暴估算中英文混排下误差能到30%以上老老实实逐字量宽度才是正道。2.3 代理绘制中取度量的正确姿势自绘控件和代理里经常需要根据当前状态选中、悬停决定用哪个字体。很多人的写法是QFont font option.font; font.setBold(true); QFontMetrics fm(font);这个写法没有错但要注意一个坑如果option.font带上了控件样式表里的字体而且样式表字体又特别特殊QFontMetrics去量它可能跟最终渲染不一致。最稳的做法是设置完字体后直接用fm(font)量不要复用别处算好的度量值。因为字体族的回退可能导致实际字体跟请求字体不一致度量值自然也对不上。我自己调试这类问题时习惯临时在绘制代码里加几行输出把fm.height()、fm.horizontalAdvance()、actualFont.family()都打出来比对一遍通常能找到问题根源。3. 字体匹配、回退和QFontInfo3.1 QFont是怎么找到实际字体的你设置QFont(Helvetica, 12)系统没有Helvetica怎么办Qt不会直接告诉你“找不到”而是走一套字体匹配逻辑按字体族名在系统字体库查找找不到就按styleHint提示的类别去选同类字体。默认的styleHint是FontDefault此时各平台的策略略有差异——Windows上可能会给你ArialLinux上可能是Liberation SansmacOS上可能是Helvetica Neue。这套隐式回退机制的本意是跨平台兼容但也带来了一个典型问题设计稿上用的是ArialLinux上跑起来变成了Liberation Sans字宽不同导致按钮文字被截断。这事的解法很简单发布软件时明确指定字体族尤其是在Windows上把微软雅黑写进代码Linux上提供fallback列表QFont font({Microsoft YaHei, PingFang SC, Noto Sans CJK SC, WenQuanYi Micro Hei}, 9);这个构造方式会依次尝试谁存在用谁。实测在Ubuntu上部署Windows风格的界面这一招能省掉一大半字体相关的bug。3.2 QFontInfo拿到“实际生效”的字体QFont是“请求”QFontInfo是“结果”。同一套设置在不同机器上可能解析出完全不同的字体QFontInfo能把真实结果暴露给你QFont font(Arial, 12); QFontInfo info(font); qDebug() info.family() info.pointSize() info.bold();注意一个细节QFontInfo必须在QApplication构造之后再使用因为底层字体数据库的初始化依赖QGuiApplication。过早使用结果可能不准。真实的价值在于发布前用QFontInfo检查一遍目标平台的实际字体能提前发现字体回退导致的布局异常。我在CI脚本里加过一段自检代码每台打包机跑一遍把几个关键控件用到的字体族和度量值输出成日志线上字体出问题时有据可查。3.3 中文字体族名的坑中文字体这块有历史遗留问题。Windows上微软雅黑的family名是“Microsoft YaHei”但旧系统里老宋体可能被注册成“SimSun”而有些程序里写“宋体”也能匹配到。这个匹配其实是Qt通过字体数据库的别名机制实现的但不保证全平台都有效。更坑的是Linux上中文字体命名极其混乱。Noto Sans CJK SC在不同发行版上注册名可能带后缀比如“Noto Sans CJK SC”和“Noto Sans CJK SC Regular”不是一个族。分享一个实战经验不要硬编码一个中文字体名而是用QFontDatabase::families()把系统里的字体族全列出来再按优先级匹配static QString findChineseFont() { const QStringList preferred { Microsoft YaHei, PingFang SC, Noto Sans CJK SC, Noto Sans SC, WenQuanYi Micro Hei, SimHei }; const QStringList all QFontDatabase().families(); for (const QString name : preferred) { if (all.contains(name)) return name; } return QString(); }这段代码我实际用在跨平台项目里能在Windows、macOS、Ubuntu、Deepin上自动挑一个中文正常的字体比写死一个字体名稳得多。4. 把QFont用在实际布局和高DPI场景4.1 全局字体设置的正确姿势QApplication有个setFont方法很多人直接在main函数里QApplication app(argc, argv); QFont font(Microsoft YaHei, 9); app.setFont(font);这样确实能改掉全局字体但有两个隐患。一是QSS里通过font-family明确指定了字体的控件全局font对它们无效二是如果你在main函数里调用了app.setFont而后续代码又通过样式表改了字体两套机制混在一起调试时很难判断谁生效。更可控的方式是给顶层窗口设置字体子控件默认继承父级字体MainWindow w; w.setFont(QFont(Microsoft YaHei, 9)); w.show();注意继承不是绝对的。对话框、单独的QWidget如果显式设置了字体会打断继承链。链条层数多了以后检查实际生效的字体还是得靠QFontInfo。4.2 高分屏和DPI变化的字体适配这是QFont最容易被误解的地方。Qt 5.6以后在Windows上有两种DPI适配模式Qt::AA_EnableHighDpiScaling由Qt自己缩放和Per-Monitor DPI Aware由Windows系统缩放。不管哪种你代码里写的pointSize在UI层面看是“一致的大小”但物理像素数会随DPI变化。我的建议是三条字体大小统一用pointSize让Qt或系统处理缩放。不要在高DPI环境下用pixelSize写死自绘文本的大小否则画出来的字在4K屏上小得没法看。监听DPI变化事件。如果软件支持运行时跨屏拖拽处理devicePixelRatio的变化重新计算字体和布局。一个实际例子项目里有个自绘波形控件上面要画刻度文字一开始用pixelSize固定大小。客户在4K屏上反馈刻度字太小改成QFont font baseFont; font.setPointSizeF(font.pointSizeF() * DPR)后解决。这个乘数的意义在于把逻辑坐标系下的文本尺寸放大到物理像素但严格来说更推荐直接用pointSize由Qt统一处理乘DPR只适合自绘控件的特殊场景。4.3 动态切换字重和字号信号槽里的隐形问题运行时动态改字体最常见的场景是“增大字体”无障碍功能和主题切换。很多人的做法是拿到当前字体改几个属性再set回去QFont font ui-label-font(); font.setPointSize(font.pointSize() 2); ui-label-setFont(font);小范围没问题但全局动态调字体时如果每个控件都存一份自己的QFont改起来会漏掉很多。更合理的方案是统一走一层“字体管理”维护一个基准字体QFont加个全局fontScale系数所有控件设置字体时都从这层取。控件需要特殊字重时在基准字体上派生一份但字号始终跟随全局基准走。QFont scaledFont(const QFont base, int deltaPointSize) { QFont f base; f.setPointSize(base.pointSize() deltaPointSize); return f; }这样改全局缩放只需要动一个系数不至于每个控件setFont一遍也不会有设置遗漏的问题。5. 常见问题排查与实用心得5.1 字体设置不生效先分清三条链路遇到“我明明setFont了界面还是老样子”首先要判断字体是从哪条路来的C代码setFont优先级最低容易被QSS覆盖。QSS样式表font-family、font-size显式设置后会覆盖代码里的字体设置。QPalette某些控件比如QComboBox的弹出列表字体受palette影响。排查顺序先检查有没有QSS命中了目标控件再看父级有没有设置字体最后查是否用了font-size: 12px这种单位混乱的写法。QSS里的font-size用的是像素跟pointSize的概念不同很容易造成“QSS上写的12C代码里setPointSize(12)实际表现却不一样”的困惑。5.2 字体导致的界面溢出和文字截断表格、列表里文字被截断通常是格子宽度按默认字体算的而运行时实际字体更宽。这个问题在发布到用户机器上才暴露的案例太多了开发机上装了微软雅黑用户机器上没有回退到SimSun或系统默认字体后一个汉字能宽出几个像素积累下来整行就溢出了。建议从一开始就在代码里用字体度量计算列宽而不是写死一个固定像素int colWidth fm.horizontalAdvance(headerText) 2 * margin iconSpacing;如果数据源可以按字段提前拿到最大文本可以先遍历数据求最大宽度再设置列宽。这个做法比事后收到“表格文字被截断”的bug再补丁要省事得多。5.3 字体相关的崩溃和异常表现字体本身很少直接导致崩溃但QFontDatabase和自定义字体加载用得不对确实会出问题。比如在QApplication构造之前调用QFontDatabase静态方法或者在程序退出后仍持有QFont对象都可能触发“奇怪的崩溃”。值得单独说的坑是QFontDatabase::addApplicationFont()加载外部字体文件。加载函数返回一个字体ID但这个ID不一定等于字体族名在数据库里的索引正确做法是加载后通过applicationFontFamilies(id)去拿族名再拿族名去设置QFontint id QFontDatabase::addApplicationFont(:/fonts/CustomFont.ttf); if (id ! -1) { QStringList families QFontDatabase::applicationFontFamilies(id); if (!families.isEmpty()) { QFont font(families.first(), 10); ui-label-setFont(font); } }加载外部字体后还要留意字体版权问题商业项目里尤其要核实授权范围。5.4 中英文混排和数字对齐的小技巧界面上经常出现“名称值”这种结构中文和英文/数字混排。中英文宽度差异很大如果对齐只用空格或固定宽度看起来会参差不齐。我的习惯是用QFontMetrics量出标签文本实际宽度设置QLabel的minimumWidth统一对齐int maxWidth 0; for (const QString key : keys) { maxWidth qMax(maxWidth, fm.horizontalAdvance(key)); } for (QLabel *label : labels) { label-setFixedWidth(maxWidth spacing); }数字对齐也值得提一下。表格里需要显示数字列时用font.setStyleHint(QFont::Monospace)或者直接选等宽字体族能让个位十位完美对齐比强行凑宽度好看得多。写在最后的几点体会从我这些年的使用经验看QFont最折磨人的地方不在于它本身有多复杂而在于它是一套“请求-解析-匹配-渲染”的长链条任何一个环节的假设在换一台机器后都可能失效。所以遇到字体问题第一反应不应该是改代码而是先确认当前机器实际生效的字体族、字号、DPI再判断是匹配问题还是度量问题方向对了修起来才快。另外一个小建议团队项目里最好把字体策略写进代码注释或者技术文档里比如“所有界面字体基于app基准确认特殊场景派生”这样后来接手的人不会被QSS和代码里的setFont搞得一头雾水。我自己因为吃过这个亏现在每个项目开头都会花10分钟把字体方案定下来后面省下来的排查时间远不止10分钟。
Qt QFont全解析：从字体匹配到DPI适配的实战指南
字体这事儿说大不大说小不小。做Qt界面开发的十有八九都在QFont上吃过亏——要么中文显示成方块要么高分屏下控件挤成一团要么DPI一变化整个界面直接没法看。问题看起来五花八门其实根子往往都落在同一个类上QFont。这个类表面上就是“设置一个字体”但内部牵扯到字体匹配、回退、渲染、度量、DPI换算一大堆机制不把这些搞清楚界面迟早给你颜色看。这篇就专注把QFont从里到外拆一遍。我会结合自己实际项目里踩过的坑和验证过的做法讲清楚它的构造方式、属性含义、字体度量、匹配回退逻辑以及在布局、高分屏、动态调整场景下的正确用法。文章面向的是正在用Qt做界面、想系统搞定字体问题的开发者不管你是刚入门还是已经写了两三年界面这里都有你能直接拿去用的东西。1. 先把QFont的几个底层机制弄明白1.1 构造函数和隐式共享为什么赋值这么“便宜”QFont算是Qt里典型的隐式共享类跟QString、QImage一个路数。你写下面这种代码QFont font1(Arial, 12); QFont font2 font1; font2.setBold(true);font2修改之前font1和font2底层共享同一份字体数据拷贝几乎零成本。一旦调了setBold内部触发写时复制才真正分出两套数据。这个机制的好处是你在界面里到处传QFont、存QFont都不用心疼性能它本质上是个轻量句柄。构造这块有两个高频写法强烈建议养成固定习惯QFont font1(Microsoft YaHei, 9); // 指定字体族 点阵大小 QFont font2; font2.setFamily(Microsoft YaHei); font2.setPointSize(9);第二种可读性更好尤其在需要动态修改多个属性时比构造函数一串参数清楚得多。类似的还有QFont(const QStringList families, int pointSize)这个重载传一个候选字体族列表进去Qt会按顺序尝试匹配第一个能找到的就生效找不到就往下走。这个对跨平台发布软件特别有用后面讲字体匹配时再细说。1.2 pointSize和pixelSize这个坑我见人踩过无数次QFont里有两个大小属性含义完全不同pointSize以“点”为单位。1点1/72英寸。在Qt里它跟屏幕DPI绑定同一个pointSize在96 DPI和120 DPI下实际像素尺寸不一样。pixelSize以物理像素为单位不随DPI变化。很多新手直接用setPointSize(12)在高分屏的Windows笔记本上字体显得特别小因为Qt拿到的是系统缩放后的逻辑DPI字体像素尺寸没有跟着放大。反过来有人为了字体大小统一用setPixelSize(16)结果在低DPI机器上字体偏大在高DPI上又不够大。实际项目里我的做法是能用pointSize就用pointSize同时开Qt的DPI缩放支持Qt 5.6设置Qt::AA_EnableHighDpiScalingQt 6默认开启让系统帮我们做换算。只有涉及自绘控件、导出图片这种需要精确像素对齐的场景才改用pixelSize。1.3 字重、斜体和下划线不只有boldQFont::setWeight接受的是一个0到99的整数标准值定义在QFont::Weight枚举里枚举值数值俗称Thin0极细Light25细体Normal50常规Medium57中等DemiBold63半粗Bold75粗体Black87特粗问题在于不是所有字体族都提供全套字重。微软雅黑有Light、Regular、Bold但你要设DemiBold系统匹配不上就自动回退到Regular或Bold。你设置的Weight只是一个请求值实际渲染字体由QFontInfo告诉你。如果你特别在意某个字重最好先用QFontDatabase确认字体族支持哪些字重再去做精确设置。setItalic和setUnderline相对简单一眼就懂但有个细节容易忽略setItalic(true)在某些字体族上会触发合成斜体而不是使用字体自带的斜体字形效果会有细微差异。做阅读类应用时要留意这一点。2. 字体度量布局不崩的秘密武器2.1 QFontMetrics到底量的是什么QFont只负责“描述一个字体请求”真正要拿字体去排版得靠度量类。最常用的是QFontMetrics整数精度和QFontMetricsF浮点精度前者用于屏幕绘制后者用于打印和精确排版。最关键的几个度量值QFont font(Microsoft YaHei, 9); QFontMetrics fm(font); int height fm.height(); // 行高ascent descent int ascent fm.ascent(); // 基线以上高度 int descent fm.descent(); // 基线以下高度 int lineSpacing fm.lineSpacing(); // 实际行距一般等于 height leading int leading fm.leading(); // 行距调节值 int averageCharWidth fm.averageCharWidth(); // 平均字符宽度拿height和lineSpacing举例如果你用固定行高的列表控件比如QListView的uniformItemSizes行高至少得取fm.lineSpacing()再加一点余量否则中文的拼音注音、上下标字符都会被裁掉。我习惯加2-3像素的padding视觉效果更宽松。2.2 文本宽度计算elide和换行的底层依赖fm.horizontalAdvance(const QString text)返回的是整段字符串的像素宽度这是个高频调用。按钮、标签、表格列头要做“文本超出显示省略号”的效果就是靠它先量出宽度再用fm.elidedText(text, Qt::ElideRight, maxWidth)得到截断后的字符串。这里有个性能陷阱horizontalAdvance在循环里频繁调用很贵尤其是QSS里大量使用富文本或代理里反复计算时。我见过一个列表代理每行数据变化都会调用几十次horizontalAdvance肉眼可见卡顿。优化手段要么缓存计算结果要么改用QFontMetricsF减少精度转换开销要么批量测量。换行也是一样QTextLayout做文字排版时内部会用字体度量来断行。自己写文本换行逻辑时千万别用text.length() * averageCharWidth这种粗暴估算中英文混排下误差能到30%以上老老实实逐字量宽度才是正道。2.3 代理绘制中取度量的正确姿势自绘控件和代理里经常需要根据当前状态选中、悬停决定用哪个字体。很多人的写法是QFont font option.font; font.setBold(true); QFontMetrics fm(font);这个写法没有错但要注意一个坑如果option.font带上了控件样式表里的字体而且样式表字体又特别特殊QFontMetrics去量它可能跟最终渲染不一致。最稳的做法是设置完字体后直接用fm(font)量不要复用别处算好的度量值。因为字体族的回退可能导致实际字体跟请求字体不一致度量值自然也对不上。我自己调试这类问题时习惯临时在绘制代码里加几行输出把fm.height()、fm.horizontalAdvance()、actualFont.family()都打出来比对一遍通常能找到问题根源。3. 字体匹配、回退和QFontInfo3.1 QFont是怎么找到实际字体的你设置QFont(Helvetica, 12)系统没有Helvetica怎么办Qt不会直接告诉你“找不到”而是走一套字体匹配逻辑按字体族名在系统字体库查找找不到就按styleHint提示的类别去选同类字体。默认的styleHint是FontDefault此时各平台的策略略有差异——Windows上可能会给你ArialLinux上可能是Liberation SansmacOS上可能是Helvetica Neue。这套隐式回退机制的本意是跨平台兼容但也带来了一个典型问题设计稿上用的是ArialLinux上跑起来变成了Liberation Sans字宽不同导致按钮文字被截断。这事的解法很简单发布软件时明确指定字体族尤其是在Windows上把微软雅黑写进代码Linux上提供fallback列表QFont font({Microsoft YaHei, PingFang SC, Noto Sans CJK SC, WenQuanYi Micro Hei}, 9);这个构造方式会依次尝试谁存在用谁。实测在Ubuntu上部署Windows风格的界面这一招能省掉一大半字体相关的bug。3.2 QFontInfo拿到“实际生效”的字体QFont是“请求”QFontInfo是“结果”。同一套设置在不同机器上可能解析出完全不同的字体QFontInfo能把真实结果暴露给你QFont font(Arial, 12); QFontInfo info(font); qDebug() info.family() info.pointSize() info.bold();注意一个细节QFontInfo必须在QApplication构造之后再使用因为底层字体数据库的初始化依赖QGuiApplication。过早使用结果可能不准。真实的价值在于发布前用QFontInfo检查一遍目标平台的实际字体能提前发现字体回退导致的布局异常。我在CI脚本里加过一段自检代码每台打包机跑一遍把几个关键控件用到的字体族和度量值输出成日志线上字体出问题时有据可查。3.3 中文字体族名的坑中文字体这块有历史遗留问题。Windows上微软雅黑的family名是“Microsoft YaHei”但旧系统里老宋体可能被注册成“SimSun”而有些程序里写“宋体”也能匹配到。这个匹配其实是Qt通过字体数据库的别名机制实现的但不保证全平台都有效。更坑的是Linux上中文字体命名极其混乱。Noto Sans CJK SC在不同发行版上注册名可能带后缀比如“Noto Sans CJK SC”和“Noto Sans CJK SC Regular”不是一个族。分享一个实战经验不要硬编码一个中文字体名而是用QFontDatabase::families()把系统里的字体族全列出来再按优先级匹配static QString findChineseFont() { const QStringList preferred { Microsoft YaHei, PingFang SC, Noto Sans CJK SC, Noto Sans SC, WenQuanYi Micro Hei, SimHei }; const QStringList all QFontDatabase().families(); for (const QString name : preferred) { if (all.contains(name)) return name; } return QString(); }这段代码我实际用在跨平台项目里能在Windows、macOS、Ubuntu、Deepin上自动挑一个中文正常的字体比写死一个字体名稳得多。4. 把QFont用在实际布局和高DPI场景4.1 全局字体设置的正确姿势QApplication有个setFont方法很多人直接在main函数里QApplication app(argc, argv); QFont font(Microsoft YaHei, 9); app.setFont(font);这样确实能改掉全局字体但有两个隐患。一是QSS里通过font-family明确指定了字体的控件全局font对它们无效二是如果你在main函数里调用了app.setFont而后续代码又通过样式表改了字体两套机制混在一起调试时很难判断谁生效。更可控的方式是给顶层窗口设置字体子控件默认继承父级字体MainWindow w; w.setFont(QFont(Microsoft YaHei, 9)); w.show();注意继承不是绝对的。对话框、单独的QWidget如果显式设置了字体会打断继承链。链条层数多了以后检查实际生效的字体还是得靠QFontInfo。4.2 高分屏和DPI变化的字体适配这是QFont最容易被误解的地方。Qt 5.6以后在Windows上有两种DPI适配模式Qt::AA_EnableHighDpiScaling由Qt自己缩放和Per-Monitor DPI Aware由Windows系统缩放。不管哪种你代码里写的pointSize在UI层面看是“一致的大小”但物理像素数会随DPI变化。我的建议是三条字体大小统一用pointSize让Qt或系统处理缩放。不要在高DPI环境下用pixelSize写死自绘文本的大小否则画出来的字在4K屏上小得没法看。监听DPI变化事件。如果软件支持运行时跨屏拖拽处理devicePixelRatio的变化重新计算字体和布局。一个实际例子项目里有个自绘波形控件上面要画刻度文字一开始用pixelSize固定大小。客户在4K屏上反馈刻度字太小改成QFont font baseFont; font.setPointSizeF(font.pointSizeF() * DPR)后解决。这个乘数的意义在于把逻辑坐标系下的文本尺寸放大到物理像素但严格来说更推荐直接用pointSize由Qt统一处理乘DPR只适合自绘控件的特殊场景。4.3 动态切换字重和字号信号槽里的隐形问题运行时动态改字体最常见的场景是“增大字体”无障碍功能和主题切换。很多人的做法是拿到当前字体改几个属性再set回去QFont font ui-label-font(); font.setPointSize(font.pointSize() 2); ui-label-setFont(font);小范围没问题但全局动态调字体时如果每个控件都存一份自己的QFont改起来会漏掉很多。更合理的方案是统一走一层“字体管理”维护一个基准字体QFont加个全局fontScale系数所有控件设置字体时都从这层取。控件需要特殊字重时在基准字体上派生一份但字号始终跟随全局基准走。QFont scaledFont(const QFont base, int deltaPointSize) { QFont f base; f.setPointSize(base.pointSize() deltaPointSize); return f; }这样改全局缩放只需要动一个系数不至于每个控件setFont一遍也不会有设置遗漏的问题。5. 常见问题排查与实用心得5.1 字体设置不生效先分清三条链路遇到“我明明setFont了界面还是老样子”首先要判断字体是从哪条路来的C代码setFont优先级最低容易被QSS覆盖。QSS样式表font-family、font-size显式设置后会覆盖代码里的字体设置。QPalette某些控件比如QComboBox的弹出列表字体受palette影响。排查顺序先检查有没有QSS命中了目标控件再看父级有没有设置字体最后查是否用了font-size: 12px这种单位混乱的写法。QSS里的font-size用的是像素跟pointSize的概念不同很容易造成“QSS上写的12C代码里setPointSize(12)实际表现却不一样”的困惑。5.2 字体导致的界面溢出和文字截断表格、列表里文字被截断通常是格子宽度按默认字体算的而运行时实际字体更宽。这个问题在发布到用户机器上才暴露的案例太多了开发机上装了微软雅黑用户机器上没有回退到SimSun或系统默认字体后一个汉字能宽出几个像素积累下来整行就溢出了。建议从一开始就在代码里用字体度量计算列宽而不是写死一个固定像素int colWidth fm.horizontalAdvance(headerText) 2 * margin iconSpacing;如果数据源可以按字段提前拿到最大文本可以先遍历数据求最大宽度再设置列宽。这个做法比事后收到“表格文字被截断”的bug再补丁要省事得多。5.3 字体相关的崩溃和异常表现字体本身很少直接导致崩溃但QFontDatabase和自定义字体加载用得不对确实会出问题。比如在QApplication构造之前调用QFontDatabase静态方法或者在程序退出后仍持有QFont对象都可能触发“奇怪的崩溃”。值得单独说的坑是QFontDatabase::addApplicationFont()加载外部字体文件。加载函数返回一个字体ID但这个ID不一定等于字体族名在数据库里的索引正确做法是加载后通过applicationFontFamilies(id)去拿族名再拿族名去设置QFontint id QFontDatabase::addApplicationFont(:/fonts/CustomFont.ttf); if (id ! -1) { QStringList families QFontDatabase::applicationFontFamilies(id); if (!families.isEmpty()) { QFont font(families.first(), 10); ui-label-setFont(font); } }加载外部字体后还要留意字体版权问题商业项目里尤其要核实授权范围。5.4 中英文混排和数字对齐的小技巧界面上经常出现“名称值”这种结构中文和英文/数字混排。中英文宽度差异很大如果对齐只用空格或固定宽度看起来会参差不齐。我的习惯是用QFontMetrics量出标签文本实际宽度设置QLabel的minimumWidth统一对齐int maxWidth 0; for (const QString key : keys) { maxWidth qMax(maxWidth, fm.horizontalAdvance(key)); } for (QLabel *label : labels) { label-setFixedWidth(maxWidth spacing); }数字对齐也值得提一下。表格里需要显示数字列时用font.setStyleHint(QFont::Monospace)或者直接选等宽字体族能让个位十位完美对齐比强行凑宽度好看得多。写在最后的几点体会从我这些年的使用经验看QFont最折磨人的地方不在于它本身有多复杂而在于它是一套“请求-解析-匹配-渲染”的长链条任何一个环节的假设在换一台机器后都可能失效。所以遇到字体问题第一反应不应该是改代码而是先确认当前机器实际生效的字体族、字号、DPI再判断是匹配问题还是度量问题方向对了修起来才快。另外一个小建议团队项目里最好把字体策略写进代码注释或者技术文档里比如“所有界面字体基于app基准确认特殊场景派生”这样后来接手的人不会被QSS和代码里的setFont搞得一头雾水。我自己因为吃过这个亏现在每个项目开头都会花10分钟把字体方案定下来后面省下来的排查时间远不止10分钟。
