X11环境下修改窗口标题时Ubuntu任务栏标题未更新

数据老陈

2026-9-3

问题根因

这个差异来自Ubuntu默认桌面环境的窗口管理器和任务栏实现逻辑，和Arch下你使用的窗口环境规则不同：

Ubuntu默认使用Mutter窗口管理器搭配Ubuntu Dock任务栏扩展，不会只读取EWMH规范定义的_NET_WM_NAME、_NET_WM_ICON_NAME属性，还会读取ICCCM老规范要求的WM_NAME、WM_ICON_NAME属性作为回退，你的代码只设置了前者，任务栏读取属性时拿不到新标题，就会显示窗口初始化时的默认值。
Ubuntu Dock存在特殊的应用匹配逻辑：它会优先读取窗口的WM_CLASS属性，匹配系统中对应的.desktop启动器文件，直接显示启动器文件中预定义的应用名称，完全忽略窗口动态设置的标题。如果你的窗口没有正确设置WM_CLASS，或是匹配到了名称不符的.desktop文件，就会出现窗口本体标题正常、任务栏标题不更新的问题。
你的XChangeProperty调用传参存在小问题：传入的字节长度是title.length()，没有包含C字符串末尾的\0终止符，部分容错性差的WM读取属性时会因为没找到终止符，读到内存里残留的旧字符串内容。Arch下常用的窗口管理器（KWin、i3、Xfwm等）对EWMH规范容错性更好，不会卡这几个细节，所以相同代码可以正常运行。

修复方法

按顺序补全以下逻辑即可解决问题：

保留你原有设置_NET_WM_NAME、_NET_WM_ICON_NAME的代码，把传入的长度参数加1，把字符串终止符包含进去：

XChangeProperty(dpy, win, NET_WM_NAME, UTF8_STRING, 8, PropModeReplace, (unsigned char*) title.c_str(), title.length() + 1);
XChangeProperty(dpy, win, NET_WM_ICON_NAME, UTF8_STRING, 8, PropModeReplace, (unsigned char*) title.c_str(), title.length() + 1);

补全ICCCM规范要求的传统窗口名称设置，不要只设置EWMH扩展属性：

XTextProperty title_prop;
char* title_ptr = const_cast<char*>(title.c_str());
XStringListToTextProperty(&title_ptr, 1, &title_prop);
XSetWMName(dpy, win, &title_prop);
XSetWMIconName(dpy, win, &title_prop);
XFree(title_prop.value);

正确设置窗口的WM_CLASS属性，避免Ubuntu Dock匹配到错误的.desktop启动器。如果你的窗口标题会动态变化，res_class字段建议设置为固定的应用标识字符串，不要跟随标题变动，否则会导致Dock反复匹配启动器出现图标跳动：

XClassHint class_hint = {0};
class_hint.res_name = const_cast<char*>(title.c_str()); // 实例名可以跟随当前窗口标题
class_hint.res_class = const_cast<char*>("MyApplication"); // 类名设为固定的应用标识
XSetClassHint(dpy, win, &class_hint);

所有属性修改完成后调用XFlush刷新请求队列，如果是窗口显示后动态修改标题，可以主动发送属性变更事件通知窗口管理器立刻刷新缓存，不用等下一次事件轮询：

XFlush(dpy);

注意：如果你是在窗口创建阶段设置标题，所有属性设置操作请放在XMapWindow调用之后执行，部分窗口管理器会在窗口首次映射时覆盖用户提前设置的窗口属性。

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