Qt 6.8.1安卓应用字体权重渲染跨平台不一致问题咨询

使用Qt 6.8.1开发Android应用时，遇到Windows（MSVC2022 64位）与Android（OnePlus A6013，Clang-arm64-v8a）平台字体渲染不一致的问题，测试代码未自定义样式，仅通过不同权重配置展示Text控件：

import QtQuick
import QtQuick.Layouts
import QtQuick.Controls

ApplicationWindow {
    width: 450
    height: 800
    visible: true
    title: qsTr("Hello World")

    ColumnLayout{
        Text{
            text: "[Default] ABCDabcd0123456789"
            font.pointSize: 15
        }

        Text{
            text: "[Default Thin] ABCDabcd0123456789"
            font.weight: Font.Thin
            font.pointSize: 15
        }
        Text{
            text: "[Default ExtraLight] ABCDabcd0123456789"
            font.weight: Font.ExtraLight
            font.pointSize: 15
        }
        Text{
            text: "[Default Light] ABCDabcd0123456789"
            font.weight: Font.Light
            font.pointSize: 15
        }
        Text{
            text: "[Default Normal] ABCDabcd0123456789"
            font.weight: Font.Normal
            font.pointSize: 15
        }
        Text{
            text: "[Default Medium] ABCDabcd0123456789"
            font.weight: Font.Medium
            font.pointSize: 15
        }
        Text{
            text: "[Default DemiBold] ABCDabcd0123456789"
            font.weight: Font.DemiBold
            font.pointSize: 15
        }
        Text{
            text: "[Default Bold] ABCDabcd0123456789"
            font.weight: Font.Bold
            font.pointSize: 15
        }
        Text{
            text: "[Default ExtraBold] ABCDabcd0123456789"
            font.weight: Font.ExtraBold
            font.pointSize: 15
        }
        Text{
            text: "[Default Black] ABCDabcd0123456789"
            font.weight: Font.Black
            font.pointSize: 15
        }

        Rectangle{
            Layout.preferredWidth: parent.width
            Layout.preferredHeight: 4
            radius: 8
            color: "#000000"
        }
    }
}

核心现象 #

• Android端默认字体：多数权重设置下，数字比字母更细，Windows端无此差异
• 加载Roboto可变字体（Roboto-VariableFont_wdth,wght.ttf）后：
  • Android端：默认字体渲染恢复正常，疑似被Roboto替换
  • Windows端：仅显示两种权重，将font.family: robotoFont改为font.family: robotoFont.name后，权重显示正常，但跨平台渲染差异仍存在

排查与解决指引 #

1. 字体匹配与Fallback机制差异

   • Android和Windows系统默认字体不同，Qt在不同平台的字体 fallback 逻辑有区别。Android默认可能使用Noto Sans这类字体，其数字与字母的权重映射和Windows默认的Segoe UI不一致
   • 强制指定统一字体时，需确认QFontDatabase是否正确识别Roboto的可变轴（wght/wdth），可通过打印字体属性验证加载状态

2. Qt字体渲染引擎平台差异

   • Windows使用DirectWrite，Android使用FreeType，两者对字体权重插值、字形渲染的逻辑不同。可尝试切换渲染后端：

     QGuiApplication::setAttribute(Qt::AA_UseOpenGLES);
     // 或
     QGuiApplication::setAttribute(Qt::AA_UseSoftwareOpenGL);
     

     测试是否影响渲染效果

3. 可变字体加载细节

   • 加载Roboto可变字体时，确保通过QFontDatabase::addApplicationFont正确加载，验证QFont是否关联到字体的可变轴。对于Windows平台，部分系统版本对可变字体支持有限，可尝试使用按权重拆分的静态Roboto字体作为 fallback

4. 字体权重映射适配

   • Qt的Font.Weight枚举在不同平台的实际映射可能有偏差，可通过QFont::weight()获取实际应用的权重值，对比两端差异，必要时针对平台手动微调权重值

5. 工具验证

   • 使用QFontDatabase::families()查看平台加载的字体列表，确认默认字体和自定义字体的加载状态
   • 借助Qt的FontLoader组件加载字体，打印status属性排查加载失败或部分加载的情况

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