如何通过GTK Text Buffer准确检测用户编辑操作？

核心思路：利用TextBuffer的精准信号追踪 #

GTK4的GtkTextBuffer提供了直接获取编辑细节的信号，无需通过模糊的变更通知，以下是具体实现方案：

1. 监听insert-text信号获取插入信息 #

该信号会在文本插入时触发，直接提供插入位置和内容：

static void on_insert_text(GtkTextBuffer *buffer, GtkTextIter *pos, const gchar *text, gint length, gpointer user_data) {
    // 获取插入位置的偏移量
    gint insert_offset = gtk_text_iter_get_offset(pos);
    // 输出插入的文本和位置（可替换为你的局部高亮逻辑）
    g_print("插入文本：%.*s，位置偏移：%d\n", length, text, insert_offset);
    
    // 仅对插入区域及相邻范围执行高亮更新
    update_highlight_for_range(buffer, insert_offset, insert_offset + length);
}

2. 监听delete-range信号获取删除信息 #

该信号在文本删除时触发，直接给出删除的起止范围：

static void on_delete_range(GtkTextBuffer *buffer, GtkTextIter *start, GtkTextIter *end, gpointer user_data) {
    gint start_offset = gtk_text_iter_get_offset(start);
    gint end_offset = gtk_text_iter_get_offset(end);
    // 输出删除范围（可替换为你的高亮清理逻辑）
    g_print("删除范围：%d 到 %d\n", start_offset, end_offset);
    
    // 移除该范围的高亮，并重新检查前后相邻区域的高亮规则
    clear_highlight_for_range(buffer, start_offset, end_offset);
    update_highlight_for_range(buffer, start_offset - 10, start_offset);
    update_highlight_for_range(buffer, end_offset, end_offset + 10);
}

3. 处理替换操作 #

替换操作本质是先触发delete-range再触发insert-text，可以通过全局标记关联两个事件：

static gboolean is_replacing = FALSE;

// 在delete-range回调中标记替换开始
static void on_delete_range(GtkTextBuffer *buffer, GtkTextIter *start, GtkTextIter *end, gpointer user_data) {
    // 判断是否是替换：删除范围和后续插入位置重合
    GtkTextIter cursor;
    gtk_text_buffer_get_iter_at_mark(buffer, &cursor, gtk_text_buffer_get_insert(buffer));
    if (gtk_text_iter_equal(start, &cursor)) {
        is_replacing = TRUE;
    }
    // 原有删除处理逻辑...
}

// 在insert-text回调中处理替换
static void on_insert_text(GtkTextBuffer *buffer, GtkTextIter *pos, const gchar *text, gint length, gpointer user_data) {
    if (is_replacing) {
        gint replace_offset = gtk_text_iter_get_offset(pos);
        g_print("替换内容：%.*s，位置偏移：%d\n", length, text, replace_offset);
        // 执行替换后的局部高亮更新
        update_highlight_for_range(buffer, replace_offset - 10, replace_offset + length + 10);
        is_replacing = FALSE;
    } else {
        // 原有插入处理逻辑...
    }
}

4. 信号绑定初始化 #

在创建TextBuffer后，绑定上述信号：

GtkTextBuffer *buffer = gtk_text_view_get_buffer(GTK_TEXT_VIEW(text_view));
g_signal_connect(buffer, "insert-text", G_CALLBACK(on_insert_text), NULL);
g_signal_connect(buffer, "delete-range", G_CALLBACK(on_delete_range), NULL);

新手注意事项 #

• GtkTextIter是GTK文本定位的核心工具，需熟悉gtk_text_iter_get_offset()、gtk_text_iter_forward_chars()等方法的使用
• 局部高亮时，无需处理整个文本，只需针对变更区域前后扩展少量字符（比如10个）即可覆盖语法上下文
• 批量粘贴文本时，insert-text会一次性传递完整内容，无需逐字符处理

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