PySide2中自定义Roboto字体无法加载问题求助

排查步骤与解决方案 #

1. 确认字体的实际族名和样式细节 #

加载字体后，不要仅依赖families[0]的输出，进一步打印该字体族下的所有可用样式，确保你使用的样式名与字体文件实际匹配：

from PySide2.QtGui import QFontDatabase

font_id = QFontDatabase.addApplicationFont("Roboto-Regular.ttf")
families = QFontDatabase.applicationFontFamilies(font_id)
db = QFontDatabase()
# 打印该字体族的所有样式
print(db.styles(families[0]))

例如输出可能是['Normal']而非你预设的['Regular']，此时样式表需要匹配实际的样式属性（如font-weight: normal;）。

2. 调整样式表的写法 #

Qt样式表引用自定义字体时，常需明确指定字重（font-weight）来匹配字体文件的实际属性。比如Roboto Regular对应的字重是400，完整写法如下：

QLabel {
    font-family: 'Roboto';
    font-size: 14pt;
    font-weight: 400; /* 对应Regular样式 */
}

若加载的是Roboto-Bold文件，字重则需设为700，以此类推。

3. 确保字体加载时机正确 #

必须在所有UI控件创建前加载字体——即先实例化QApplication，再执行addApplicationFont，最后创建窗口和控件。否则控件会优先使用默认字体初始化，后续样式表可能无法覆盖：

app = QApplication(sys.argv)
# 先加载字体
font_id = QFontDatabase.addApplicationFont("Roboto-Regular.ttf")
# 再创建UI控件
window = QWidget()
# ... 后续控件创建代码

4. 用代码设置字体验证加载有效性 #

跳过样式表，直接用代码设置字体，验证字体是否能正常渲染：

label = QLabel("测试文本")
font = QFont("Roboto", 16)
label.setFont(font)

如果这段代码能正常显示Roboto字体，说明问题出在样式表写法；若仍不生效，说明字体文件本身存在损坏或版本不兼容问题，建议更换官方完整的Roboto字体文件重试。

5. 检查字体文件的完整性 #

确保你加载的是完整的Roboto字体包（包含全样式版本），部分精简版字体可能缺少对应样式，导致样式表匹配失败。

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