Qt按钮中英文字符（Arial字体）下划线显示不全问题求助

我之前做Qt界面开发时刚好踩过这个坑，中英文混合文本搭配Arial这类西文字体时，下划线断片的情况确实很常见，而且Qt Designer里能复现的话，基本可以锁定是字体渲染层面的兼容问题，给你梳理下原因和几个亲测有效的解决思路：

核心原因 #

这个问题本质是Qt的字体 fallback 机制导致的：

• Arial是纯西文字体，没有中文字符的字形（glyph），所以当按钮文本包含中文时，Qt会自动 fallback 到系统默认的中文字体（比如Windows下的微软雅黑、Mac下的PingFang SC）。
• 西文字体和中文字体的基线（baseline）、下划线位置/粗细参数差异很大，Qt默认的下划线是按单一行的基准绘制的，两种字体的下划线衔接不上，就会出现“断片”或者部分缺失的情况。

解决思路 #

1. 换用支持中英文的统一字体 #

这是最简单直接的方法，用本身包含中英文字符的字体，避免Qt触发字体 fallback：

• 推荐字体：Noto Sans SC（Google开源的无衬线字体，全平台兼容）、微软雅黑（Windows系统自带）、PingFang SC（Mac/iOS系统自带）。
• 操作方式：在Qt Designer里选中按钮，直接在属性面板的font选项里切换成上述字体；代码里的话可以这么写：

QFont btnFont("Noto Sans SC", 12); // 12是字号，按需调整
ui->pushButton->setFont(btnFont);

换完字体后，下划线会跟着统一的字体渲染，自然就完整了。

2. 自定义按钮的下划线绘制逻辑 #

如果必须用Arial字体，那可以自己接管下划线的绘制，绕过Qt默认的渲染逻辑：

• 自定义一个继承自QPushButton的类，重写paintEvent方法，手动绘制文本和下划线：

#include <QPushButton>
#include <QPainter>
#include <QFontMetrics>

class CustomUnderlineButton : public QPushButton {
    Q_OBJECT
public:
    explicit CustomUnderlineButton(QWidget *parent = nullptr) : QPushButton(parent) {}

protected:
    void paintEvent(QPaintEvent *event) override {
        // 先让按钮绘制默认内容
        QPushButton::paintEvent(event);
        
        QPainter painter(this);
        painter.setPen(QPen(palette().color(QPalette::Text), 1, Qt::SolidLine));
        
        // 计算下划线的位置和长度，基于当前文本的字体 metrics
        QRect textRect = rect();
        QFontMetrics fm = fontMetrics();
        // 下划线位置：在文本基线下方2像素，可按需调整
        int underlineY = textRect.bottom() - fm.descent() + 2;
        // 下划线起始和结束位置：对齐文本的左右边界
        int startX = textRect.left() + fm.leftBearing(text().at(0));
        int endX = textRect.right() - fm.rightBearing(text().back());
        
        painter.drawLine(startX, underlineY, endX, underlineY);
    }
};

这样不管用什么字体，下划线都是你自己控制的直线，不会出现断片的情况。

3. 调整Qt字体渲染策略（备选方案） #

这个方法效果不稳定，但可以试试：强制Qt使用单一字体的渲染参数，或者调整字体的样式策略：

QFont arialFont("Arial", 12);
// 设置字体策略为优先使用默认样式，减少fallback的影响
arialFont.setStyleStrategy(QFont::PreferDefault);
ui->pushButton->setFont(arialFont);

不过因为Arial本身没有中文字符，最终还是会 fallback 到中文字体，所以这个方法只能缓解，不能彻底解决问题，还是前两种方法更靠谱。

快速验证方法 #

在Qt Designer里先把按钮字体换成Noto Sans SC，如果下划线立刻变完整，那就坐实是字体 fallback 的问题，直接用方法1就行；如果必须用Arial，再考虑方法2。

内容的提问来源于stack exchange，提问作者Rolf