WezTerm Lua 指南window:get_title() 获取与理解窗口标题【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/weztermwindow:get_title()是 WezTerm 为mux-window对象提供的窗口标题查询方法用于读取当前 GUI 窗口Mux 窗口的标题字符串。该标题可能由终端内运行的应用通过OSC 0/OSC 2转义序列写入也可能由 Lua 侧通过window:set_title()显式设置。读完本文你将掌握该方法的调用方式、标题的来源链路、底层实现原理以及如何在状态栏、标题格式化等真实配置场景中使用它。方法签名与引入版本window:get_title()所属对象window即mux-window类型代表一个 WezTerm GUI 窗口返回值string即当前窗口的标题引入版本20220807-113146-c2fee766{{since(20220807-113146-c2fee766)}}标记说明该 API 自该版本起可用使用更早版本时请先升级该方法与配套的window:set_title(TITLE)成对出现后者在 set_title.md 中有独立文档window:set_title my title两者的版本引入时间一致因此可以安全地搭配使用。窗口标题的三种来源按官方文档定义window:get_title()返回的标题来自以下途径OSC 0/OSC 2转义序列应用侧写入终端内运行的程序通过操作系统控制序列OSC修改标题。OSC 2用于设置窗口标题Window TitleOSC 0则会同时设置图标标题Icon Name与窗口标题。常见的 shell 提示符插件、TUI 工具如 vim、htop、任务管理器等都会借此把「当前路径」「正在编辑的文件」「git 分支」等信息写进窗口标题。文档中as set byOSC 0,OSC 2in a contained pane在某个 pane 中通过 OSC 0/OSC 2 设置指的就是这条链路。window:set_title()Lua 侧写入在 Lua 配置/事件回调中主动调用window:set_title()设置的标题。继承/同步自 Mux 层窗口标题最终存储在 Mux 的Window结构中详见下文源码解析无论标题由哪一侧写入get_title()读到的都是同一份数据。需要注意的边界get_title()返回的是窗口window级标题而 Tab 级标题由tab:get_title()维护两者是不同维度的状态——一个窗口可能包含多个 Tab每个 Tab 各有自己的标题。源码实现标题在 Mux 层如何存储与读取window:get_title()的底层实现在 Mux 层。核心结构位于 mux/src/window.rspub struct Window { id: WindowId, tabs: VecArcTab, active_tab_idx: usize, last_active_tab_id: OptionTabId, workspace: String, title: String, // 窗口标题存储于此 initial_position: OptionGuiPosition, }对应的读写方法/// Set window title, notifying listeners if it changed. pub fn set_title(mut self, title: str) { if self.title ! title { self.title title.to_string(); Mux::try_get().map(|mux| { mux.notify(MuxNotification::WindowTitleChanged { window_id: self.id, title: title.to_string(), }) }); } } /// Return current title. pub fn get_title(self) - str { self.title }从源码结构可以归纳出三点实现细节标题是 MuxWindow的普通字符串字段get_title()只是返回self.title不经过任何计算或重绘开销极低可以在高频回调中安全调用。set_title()带变更通知只有当新标题与旧标题不同时才会更新字段并通过MuxNotification::WindowTitleChanged通知各监听方。也就是说标题是否变化是可观测的Lua 事件系统如标题相关的重绘流程依赖这一通知机制。窗口身份独立于标题Window通过WindowIdusize唯一标识标题只是其附属状态同一窗口的标题在运行期间可以被反复改写。在 GUI 侧Lua 的mux-window对象由 wezterm-gui/src/scripting/guiwin.rs 中的GuiWin表示它持有mux_window_id并提供了mux_window()方法把 GUI 窗口映射为 Mux 窗口对象methods.add_method(mux_window, |_, this, _: ()| { Ok(mux_lua::MuxWindow(this.mux_window_id)) });MuxWindow上的get_title()方法最终即调用上面 mux/src/window.rs 中的get_title()。从源码结构看这一调用链是「Lua 层window:get_title()→mux_lua::MuxWindow::get_title→mux::Window::get_title」全链路均为直接读取字符串字段。典型使用场景与配置示例在状态栏中展示窗口标题WezTerm 的update-right-status事件回调会获得window对象此时可直接读取窗口标题用于右侧状态栏渲染local wezterm require wezterm wezterm.on(update-right-status, function(window, pane) local title window:get_title() -- 将标题与状态栏其他信息拼装后 set_right_status 输出 window:set_right_status(wezterm.format { { Text, 窗口: .. title }, }) end)说明set_right_status是 guiwin.rs 中暴露的另一个window方法与标题读取配合可实现「标题实时上栏」的效果应用通过 OSC 序列改标题时标题变化会经WindowTitleChanged通知触发界面刷新。在窗口标题格式化事件中兜底显示在format-window-title事件中window:get_title()可以用于获取由应用写入的原始标题并在此基础上进行包装例如统一加前缀、限制长度。需要区分的是该事件另有专门的标题计算逻辑见 wezterm-gui/src/termwindow/mod.rs 中window_title字段的读取而get_title()返回的是 Mux 层记录的原始标题二者语义不同按需取用。结合 pane 信息使用窗口标题与 pane 标题是两套状态。若需要同时展示「窗口标题 当前 pane 的标题」可以配合window:active_pane()使用其中 pane 级标题在 termwindow/mod.rs 等位置通过pos.pane.get_title()获取。典型取舍是窗口标题反映「整个窗口被谁设置」pane 标题反映「当前活动 Tab 里的进程」按展示粒度选择。注意事项应用可能随时覆盖标题window:set_title()的文档明确指出「applications may subsequently change the title via escape sequences」——即使你在 Lua 中设置了标题终端内应用后续仍可通过OSC 0/OSC 2改写它。因此不要把set_title当作最终不可变标题get_title()读到的始终是最近一次写入的值。版本门槛该方法自20220807-113146-c2fee766起可用若你的配置文件需要兼容更早版本请先做wezterm.version判断或直接升级 WezTerm。只在有window对象处可用get_title()是mux-window的方法只能在能拿到window对象的事件回调如update-right-status、format-window-title或经过window:mux_window()映射后的对象上调用不能在纯 mux 上下文例如wezterm.mux相关回调中的window_id直接使用。空字符串初始值从 mux/src/window.rs 可以看到新窗口创建时title: String::new()即在没有任何来源设置标题前get_title()返回空字符串。小结window:get_title()是一个轻量、同步的标题读取 API其数据源统一为 Mux 层 Window 结构体 的title字段标题既可以来自终端应用的OSC 0/OSC 2转义序列也可以来自 Lua 的window:set_title()。配合状态栏渲染、标题格式化等事件回调可以构建出「标题实时感知」的个性化终端界面。需要反向操作时请查阅 set_title.md 了解对应写入方法。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考