深入浅出 Qt QFont：掌握字体设置、嵌入及样式表替代方案
2025-12-03
在 Qt 应用程序中，QFont 类用于描述字体的特征，例如字体家族（如 Arial、宋体）、字号、粗细（加粗/普通）、斜体以及是否带下划线等。它是 Qt 渲染文本的基础。
您可以通过以下方式创建或获取一个 QFont 对象
默认构造函数 创建一个使用应用程序默认字体的 QFont。
通过名称和大小 QFont("Arial", 10)
从已有的部件获取 widget->font()
在使用 QFont 时，开发者经常会遇到以下几个问题
问题描述 您设置了特定的字体（例如一个中文/日文字体），但在运行时，显示的文本却不是该字体，或者显示为方块。
根本原因
系统中缺少该字体 Qt 应用程序运行的设备上没有您请求的字体文件。
字体名称不准确 您使用的字体名称（例如拼写错误或使用了与系统记录不完全一致的名称）未能被系统识别。
字体回退 (Font Fallback) 如果请求的字体不支持某些字符（如中文），系统会自动回退到另一个支持这些字符的字体，这可能不是您想要的。
解决方案及示例代码
使用通用的字体族（推荐中文） 尝试使用 Qt 建议的通用字体名称，或者确保使用系统真正支持的名称（例如在 Windows 上测试的字体在 Linux 或 macOS 上可能不存在）。
// 尝试设置一个常见的、跨平台的字体族
QFont font("SimHei", 12); // "SimHei" 是黑体，在中文系统上通常可用
font.setWeight(QFont::Bold);
// 检查设置是否成功，如果失败，Qt 会回退到默认字体
if (font.exactMatch()) {
qDebug() << "字体设置成功：" << font.family();
} else {
qDebug() << "请求的字体家族可能不存在，实际使用的是：" << font.family();
}
label->setFont(font);
label->setText("你好，世界！");
问题描述 您设置了一个固定的字号（例如 10pt 或 14px），但在高分屏或不同操作系统上运行时，文本看起来太小或太大。
根本原因
字号单位 point (pt) 是一个物理单位（1pt=1/72 英寸），而 pixel (px) 是一个依赖于屏幕分辨率的单位。在高 DPI 屏幕上，Qt 会自动缩放，但有时表现仍不理想。
缺乏 DPI 意识 应用程序没有考虑到当前屏幕的 DPI (Dots Per Inch) 缩放因子。
解决方案及示例代码
使用逻辑像素 (Logical Pixels) 或默认缩放 依赖 Qt 的自动高 DPI 缩放机制。在大多数情况下，设置一个标准的 point 大小是最好的跨平台选择。
使用 QApplicationsetAttribute 确保在应用程序启动时启用高 DPI 缩放（如果需要）。
// 在 main() 函数的 QApplication 实例化之前调用
// 这有助于在高 DPI 屏幕上进行自动缩放
QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
// 默认使用 PointSize
QFont font;
font.setPointSize(10); // 10pt，Qt 会根据屏幕 DPI 进行适当的缩放
widget->setFont(font);
// 如果确实需要使用像素大小，请使用 setPixelSize
// 但请注意，这在高 DPI 屏幕上可能需要手动调整
// font.setPixelSize(14);
问题描述 您的应用程序使用了一个非标准的字体，而您无法保证用户的系统上一定安装了它。
根本原因 字体文件不在系统路径中，因此 Qt 无法找到它。
解决方案及示例代码
使用 QFontDatabase 嵌入字体 将字体文件（如 .ttf 或 .otf）添加到 Qt 的资源文件（.qrc）中，然后使用 QFontDatabase 加载它。
#include
// 假设您的资源文件 (my_app.qrc) 中有一个字体文件，路径为 :/fonts/MyCustomFont.ttf
int id = QFontDatabase::addApplicationFont(":/fonts/MyCustomFont.ttf");
if (id != -1) {
QString family = QFontDatabase::applicationFontFamilies(id).at(0);
// 现在可以使用字体家族名称来创建 QFont
QFont customFont(family, 14);
label->setFont(customFont);
label->setText("使用自定义字体");
} else {
qWarning("无法加载自定义字体文件！");
}
虽然 QFont 是设置字体的标准方法，但在某些情况下，使用 Qt 的富文本或样式表可能更方便、更灵活。
对于简单的文本部件（如 QLabel, QPushButton, QLineEdit），使用样式表来设置字体属性非常方便，它类似于网页中的 CSS。
优点 代码简洁，易于修改，可以将样式与逻辑分离。
示例代码 (C++)
QLabel *label = new QLabel("你好，样式表！");
// 使用样式表设置字体：家族、大小、粗细
label->setStyleSheet("QLabel {"
"font-family: 'Times New Roman', '黑体';" // 尝试使用多个，逗号分隔
"font-size: 16pt;"
"font-weight: bold;" // 可以是 bold, normal, 500 等
"color: blue;"
"}");
对于 QLabel, QTextEdit, QTextBrowser 等支持富文本的部件，您可以使用 HTML 标签直接在文本内容中指定字体样式。
优点 可以在一个文本块中混用多种字体、颜色和样式。
示例代码 (C++)
QLabel *label = new QLabel();
// 使用 标签设置字体、大小和颜色
label->setText("这是一个 大号红色 Arial 文本，后面是 小号斜体中文。");
// 确保文本被解析为富文本
label->setTextFormat(Qt::RichText);
对于大多数情况，直接使用 QFont 是最直接和灵活的方法。但如果需要全局样式或在一个控件内实现多种样式，样式表和富文本则是更高效的替代方案。