如何在不安装外部字体的情况下为Gtk特定控件使用自定义字体？

由于Gtk确实不支持CSS的@font-face语法，你可以通过Pango加载本地字体文件+给目标按钮单独设置字体属性的方式实现需求，无需全局配置或要求用户安装字体。

步骤1：加载本地字体文件到Pango #

Pango可以直接加载本地字体文件，无需系统安装。根据平台不同，代码略有差异：

Linux/FontConfig平台

#include <pango/pango.h>
#include <pango/pangofc-fontmap.h>
#include <fontconfig/fontconfig.h>

// 加载项目内的字体文件（替换为你的字体路径）
const gchar *font_path = "./assets/custom-font.ttf";
FcConfig *fc_config = FcConfigGetCurrent();

if (FcConfigAppFontAddFile(fc_config, (const FcChar8*)font_path)) {
    FcConfigSetCurrent(fc_config);
    // 通知Pango字体配置已更新
    PangoFcFontMap *fc_font_map = PANGO_FC_FONT_MAP(pango_font_map_get_default());
    pango_fc_font_map_config_changed(fc_font_map);
} else {
    g_warning("Failed to load custom font: %s", font_path);
}

Windows平台（GDI/PangoWin32后端）

#include <pango/pangowin32.h>

// 加载项目内的字体文件（替换为你的字体路径）
const wchar_t *font_path = L"./assets/custom-font.ttf";
PangoWin32FontMap *win_font_map = PANGO_WIN32_FONT_MAP(pango_font_map_get_default());

if (!pango_win32_font_map_add_font_file(win_font_map, font_path)) {
    g_warning("Failed to load custom font");
}

步骤2：给单个按钮设置自定义字体 #

加载字体后，你可以通过两种方式给目标按钮单独应用该字体：

方式1：通过GtkStyleContext设置（推荐，适配CSS类）

先给按钮标记一个CSS类，再通过代码设置字体描述：

// 创建目标按钮
GtkWidget *target_button = gtk_button_new_with_label("我是自定义字体按钮");
// 添加CSS类（方便后续如果需要其他样式调整）
gtk_widget_add_css_class(target_button, "custom-font-btn");

// 创建字体描述（替换为你的字体家族名和字号）
PangoFontDescription *font_desc = pango_font_description_from_string("CustomFontFamily 14");
// 获取按钮的样式上下文，设置字体
GtkStyleContext *context = gtk_widget_get_style_context(target_button);
gtk_style_context_set_font(context, font_desc);

// 释放资源
pango_font_description_free(font_desc);

方式2：直接给按钮的Label设置Pango属性

如果只需要修改文本字体，也可以直接操作按钮内部的Label控件：

GtkWidget *target_button = gtk_button_new_with_label("我是自定义字体按钮");
GtkLabel *btn_label = GTK_LABEL(gtk_button_get_child(GTK_BUTTON(target_button)));

// 创建字体属性
PangoAttrList *attr_list = pango_attr_list_new();
PangoFontDescription *font_desc = pango_font_description_from_string("CustomFontFamily 14");
PangoAttribute *font_attr = pango_attr_font_desc_new(font_desc);

// 将属性应用到Label
pango_attr_list_insert(attr_list, font_attr);
gtk_label_set_attributes(btn_label, attr_list);

// 释放资源
pango_font_description_free(font_desc);
pango_attr_list_unref(attr_list);

关键注意事项 #

• 字体家族名：不是字体文件名，而是字体内部的家族名称。可以通过工具查看：
  • Linux：用fc-scan ./custom-font.ttf命令，查找family:字段
  • Windows：右键字体文件选择“属性”，查看“详细信息”里的“字体名称”
• 路径正确性：建议用绝对路径，或者通过g_get_current_dir()获取程序运行目录，拼接字体文件路径，避免相对路径出错
• GTK版本适配：上述代码针对GTK4，GTK3的API略有不同（比如gtk_style_context_add_class代替gtk_widget_add_css_class）

内容的提问来源于stack exchange，提问作者e-info128