这个问题的核心在于Font Awesome 5的字体结构设计，以及QML和QWidgets在字体权重匹配上的差异——尤其是macOS/iOS/Android平台对字体规则的严格性，放大了这个问题。

问题根源 #

Font Awesome 5把不同风格的图标拆分到了不同的字体变体/权重中：

• Solid风格图标（比如\uf002搜索图标、\uf4b4文件图标）：属于Font Awesome 5 Free字体的Bold权重（对应字体文件Font Awesome 5 Free-Solid-900.ttf）
• Regular风格图标（比如\uf2bb垃圾桶图标）：属于Font Awesome 5 Free字体的Normal权重（对应Font Awesome 5 Free-Regular-400.ttf）
• Brands风格图标：单独属于Font Awesome 5 Brands字体家族，使用Normal权重

Windows平台对字体匹配的容错性较高，可能会自动 fallback到存在的权重变体，但macOS/iOS/Android的字体系统更严格，必须明确指定正确的权重才能加载对应图标。而QWidgets在字体处理上更宽松，或者你在QWidgets中隐式设置了正确的权重，所以所有图标都能正常显示。

解决办法 #

1. 针对单个图标指定正确权重

根据图标的风格，明确设置font.weight：

• 显示Solid图标时，必须设置font.weight: Font.Bold：

Label {
    text: "\uf002" // 搜索图标（Solid风格）
    font.family: "Font Awesome 5 Free"
    font.weight: Font.Bold // 关键设置！
}

• 显示Regular图标时，使用Normal权重：

Label {
    text: "\uf2bb" // 垃圾桶图标（Regular风格）
    font.family: "Font Awesome 5 Free"
    font.weight: Font.Normal
}

2. 混合不同风格图标（用富文本）

如果需要在同一个文本中混合不同风格的图标，推荐使用Text控件并开启富文本格式，通过内联样式指定每个图标的字体和权重：

Text {
    textFormat: Text.RichText
    text: "<span style='font-family: \"Font Awesome 5 Free\"; font-weight: bold;'>\uf002</span> x <span style='font-family: \"Font Awesome 5 Free\"; font-weight: normal;'>\uf2bb</span>"
}

3. 确保所有字体变体正确加载

虽然你已经通过Qt.fontFamilies()验证了字体存在，但建议在C++代码中手动加载所有Font Awesome的字体文件，确保QML能识别到完整的权重变体：

#include <QFontDatabase>

void loadFontAwesome() {
    // 替换为你的字体文件路径，建议放到Qt资源文件中
    int solidFontId = QFontDatabase::addApplicationFont(":/fonts/Font Awesome 5 Free-Solid-900.ttf");
    int regularFontId = QFontDatabase::addApplicationFont(":/fonts/Font Awesome 5 Free-Regular-400.ttf");
    int brandsFontId = QFontDatabase::addApplicationFont(":/fonts/Font Awesome 5 Brands-Regular-400.ttf");

    if (solidFontId == -1 || regularFontId == -1 || brandsFontId == -1) {
        qWarning() << "Failed to load one or more Font Awesome fonts";
    }
}

// 在main函数中调用
int main(int argc, char *argv[]) {
    QGuiApplication app(argc, argv);
    loadFontAwesome();
    // ... 其他初始化代码
    return app.exec();
}

4. 验证字体权重是否正确识别

可以添加一个小测试，查看Font Awesome 5 Free对应的可用权重：

ListView {
    anchors.fill: parent
    model: QFontDatabase.families()
    delegate: Item {
        height: 60
        width: parent.width
        Text {
            anchors.centerIn: parent
            text: modelData + "\nAvailable weights: " + QFontDatabase.weightNames(QFontDatabase.weights(modelData))
            wrapMode: Text.Wrap
        }
    }
}

如果Font Awesome 5 Free对应的权重列表里包含Bold，说明Solid变体已正确加载。

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