如何在Gjs/Gtk主菜单栏中添加按钮？求相关技术指引

阿华AIGC实验室

2026-5-9

针对主面板（系统托盘）添加图标按钮的Gtk方案

嘿，我完全懂你的困扰——找了一堆文档都是讲应用窗口自身的菜单栏，可你要的是那种像Discord一样挂在桌面顶部主面板（系统托盘区域）的图标按钮对吧？别慌，我给你梳理下不同Gtk版本里对应的核心类和实现思路：

Gtk3 实现：用`Gtk.StatusIcon`

Gtk3里专门为系统托盘场景设计了 Gtk.StatusIcon 类，这就是你要找的核心工具：

它可以直接在系统托盘区域显示图标，支持设置tooltip提示文本
能绑定左键点击、右键菜单等交互事件

简单示例代码：

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk

# 创建托盘图标
tray_icon = Gtk.StatusIcon()
tray_icon.set_from_icon_name("discord")  # 替换成你的图标名称或绝对路径
tray_icon.set_tooltip_text("我的自定义应用")

# 绑定左键点击事件
def on_icon_clicked(icon, event):
    if event.button == 1:
        print("托盘图标被左键点击啦！")

tray_icon.connect("button-press-event", on_icon_clicked)

Gtk.main()

如果需要右键菜单，搭配Gtk.Menu和Gtk.MenuItem，绑定popup-menu事件就能实现右键弹出菜单的效果。

Gtk4 实现：弃用`StatusIcon`后的替代方案

Gtk4已经移除了Gtk.StatusIcon，这里有两个靠谱的替代方向：

1. 用`libayatana-appindicator`（兼容性首选）

这是当前跨桌面环境支持最好的方案，核心类是 AppIndicator3.Indicator：

它能稳定在GNOME、KDE、XFCE等主流桌面的托盘区域显示图标
支持绑定菜单、设置图标状态等功能

示例代码：

import gi
gi.require_version('Gtk', '4.0')
gi.require_version('AppIndicator3', '0.1')
from gi.repository import Gtk, AppIndicator3

# 创建指示器
indicator = AppIndicator3.Indicator.new(
    "my-app-tray",
    "discord",
    AppIndicator3.IndicatorCategory.APPLICATION_STATUS
)
indicator.set_status(AppIndicator3.IndicatorStatus.ACTIVE)

# 创建右键菜单
menu = Gtk.Menu()
quit_item = Gtk.MenuItem(label="退出应用")
quit_item.connect("activate", lambda _: Gtk.main_quit())
menu.append(quit_item)
menu.show_all()

indicator.set_menu(menu)

Gtk.main()