PyQt5 Designer跨Linux与Windows平台字体显示一致性问题咨询

跨平台显示效果相近的字体推荐 #

以下字体在Windows和树莓派Linux系统下预装覆盖率高、渲染风格差异极小，可直接选用：

• 无衬线常规字体优先选 Noto Sans（思源黑体）：Windows 10 1809及以上版本默认预装，树莓派官方Raspberry Pi OS所有主流版本均默认预装，字重、字符宽度、显示效果在两个平台下一致性极强，无版权风险，是跨平台适配的首选
• 备选无衬线字体选 DejaVu Sans：树莓派默认预装，Windows平台可直接随程序打包，字形和Noto Sans接近，适配成本极低
• 等宽字体优先选 Noto Sans Mono：两个平台预装覆盖率高，数字、代码类内容的显示效果一致性表现最好

跨平台字体适配最佳实践 #

• 优先设置字体优先级队列，不要依赖系统默认字体：在PyQt5全局字体配置或QSS样式中，按优先级排列字体，系统会自动匹配第一个存在的字体，示例代码：

from PyQt5.QtGui import QFont
import sys

app = QApplication(sys.argv)
target_font = QFont()
# 按优先级排列字体，前一个不存在自动匹配后一个
target_font.setFamilies(["Noto Sans", "DejaVu Sans", "Microsoft YaHei", "Sans Serif"])
target_font.setPointSize(10)
app.setFont(target_font)

• 字体随程序打包动态加载，完全消除字体存在性差异：如果担心目标平台没有预装指定字体，可将字体文件放入程序资源包，运行时动态加载，不需要修改系统配置，示例代码：

from PyQt5.QtGui import QFont, QFontDatabase

# 加载打包在程序内的字体文件，路径可替换为本地相对路径
font_id = QFontDatabase.addApplicationFont(":/res/NotoSans-Regular.ttf")
if font_id != -1:
    font_family = QFontDatabase.applicationFontFamilies(font_id)[0]
    app.setFont(QFont(font_family, 10))

• 统一DPI适配规则，避免字体大小缩放差异：在QApplication初始化前统一设置高DPI适配规则，保证两个平台下字体物理显示大小一致：

from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication

# 以下配置必须放在QApplication实例化之前
QApplication.setAttribute(Qt.AA_EnableHighDpiScaling, True)
QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps, True)

• QSS样式中字体大小统一用pt作为单位，不要用px：pt是物理字号单位，不同DPI的平台下显示一致性远高于像素单位px

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