OSC 1 — 设置图标名（与窗口标题分离）

在哪里用到

实际会发出该序列的工具——把抽象字节锚定到你已经用过的命令上。

• xterm, urxvt, gnome-terminal, konsole, mlterm, foot—所有 X11 原生终端都遵守 OSC 1 —— 图标名通过 `WM_ICON_NAME` 发布，窗口管理器可在任务栏 / 活动切换器上显示短标签（`vim`、`htop`），同时标题栏保留完整的 `vim — ~/proj/foo.c`
• tmux `set-titles-string` + `icon-string`—tmux 在 `titles-string` 之外提供独立的 `icon-string` —— 当外层终端为 X11 原生时，tmux 用 OSC 1 发送短形式（`#W`）作图标，用 OSC 2 发送长形式（`#S:#W -- #T`）作标题，沿用 xterm 惯例
• screen `caption` / `hardstatus`—GNU screen 跑在 xterm 家族终端里时，每次焦点窗口变化都发 OSC 1 —— Alt-Tab 风格切换器显示内层窗口名（`screen 0: vim`）而不是外层静态标签
• i3wm / sway / xmonad — minimised icon labels—回退到浮动布局的平铺 WM（i3 暂存区、sway 的 `move workspace`）在窗口最小化或被移到非可见工作区时显示图标名 —— 让长任务（`make all 2>&1 | tee >(grep -q ERROR && printf '\\x1b]1;BUILD FAILED\\x07')`）发 OSC 1，工作区标签就闪出有意义的内容
• non-X11 terminals (iTerm2, kitty, alacritty, wezterm, ghostty, Windows Terminal)—这些终端都没有独立的图标渲染面 —— OSC 1 被解析后丢弃（部分构建里当 OSC 0 处理）。可移植脚本应使用 OSC 0（`\x1b]0;<name>\x07`）一次性更新图标和标题，除非确实需要 X11 的分离语义

相关误区

该序列在实践中常见的踩坑——每条链接到完整的症状、成因与修复。

• ⚠OSC 1（\x1b]1;NAME）必须以 BEL（\x07）或 ST（\x1b\\）结束 —— 漏掉终止符会把后续 stdout 吞掉，直到下一个 BEL / ST 出现·#osc-terminator

常见问题

针对这条序列，开发者真正会去搜索的问题的简短回答。

OSC 0、OSC 1、OSC 2 有什么区别 —— 为什么有三个标题转义？

OSC 0 一次设置图标名和窗口标题（简写）。OSC 1 *仅*设置图标名（窗口最小化 / 图标化时显示的短标签）。OSC 2 *仅*设置窗口标题（标题栏 / 标签上的长字符串）。这种拆分源于 X11 / ICCCM —— 图标化窗口会显示独立的紧凑标签。现代终端不支持图标化（Windows Terminal、macOS Terminal.app、kitty）时，OSC 1 常常静默空操作；OSC 0 与 OSC 2 处处可用。SSH 远端标签建议用 OSC 2 —— OSC 0 在仍尊重 X11 区分的终端上可能覆盖图标。

为什么我设的图标名在 tmux 每次开新标签都会被重置？

tmux 自维护每窗口的图标名，并在活动窗口切换时向外层终端重发 OSC 1。从内层 shell 设 OSC 1 会更新*tmux 窗口的*已记录图标名，但 Ctrl-b n 切到下一窗口时，tmux 把那个窗口已存的图标推回（通常为空 → 终端回退到二进制名如 tmux）。要让图标跨窗口持续，请设 set-option -g set-titles-string '#W'，让 tmux 通过内层 shell 的 automatic-rename 机制驱动标题 —— 单窗口手动 OSC 1 无法穿越下次切换。