怎样让新标签页继承当前 shell 的工作目录？

让 shell 在每次 chpwd / PROMPT_COMMAND 时发 \x1b]7;file://hostname/绝对路径\x07。iTerm2、gnome-terminal、Konsole、kitty、ghostty、wezterm、Windows Terminal 都读取 OSC 7 并作为新标签 / 分屏的 cwd 使用。Zsh 的 vcs_info 样式和 starship 自动发送；bash 需要 PROMPT_COMMAND='printf "\033]7;file://%s%s\007" "$HOSTNAME" "$PWD"'。Fish 自 3.0 起原生支持。

为什么路径必须 URL 编码并带 file://，而不是裸路径？

OSC 7 由 GNOME / freedesktop 规定承载 URI 而非裸路径 —— 这样才能标识*主机*（SSH / 复用场景下终端与 shell 不在同机），并对非 ASCII / 空格做无损双向转换。发送 file://$HOSTNAME$PWD，其中 $PWD 做百分号编码。终端剥去 URI 前缀；若主机名与本机一致就本地解析 $PWD，否则退回用户家目录。

OSC 7 — 当前工作目录提示

把当前 shell 所在目录告知终端 —— 用于标签名、「在此目录新开标签」、远程感知的分屏工作流。

字节形式

涵盖所有常见的字符串字面量写法，方便正反查找。

\\x1b[\x1b]7;file://HOST/PATH\x07

\\033[\033]7;file://HOST/PATH\007

\\e[\e]7;file://HOST/PATH\a

ESC [ESC ] 7 ; URL BEL

hex1b 5d 37 3b ... 07

说明

把 shell 当前工作目录以 file://HOST/PATH URL 形式告知终端。iTerm2、Windows Terminal、kitty、wezterm、ghostty、Konsole 与 VTE 系（gnome-terminal、foot）均已采纳。终端用途：(a) 标签/窗格名显示目录的 basename，(b) Cmd-T/「在此处新开标签」在同一 cwd 启动新 shell，(c) tmux resurrect、wezterm mux 恢复会话时把分屏窗格还原到正确目录。shell 在每次提示符前发送 —— bash 通过 PROMPT_COMMAND、zsh 通过 precmd 或 chpwd、fish 内置 __fish_cwd_osc。SSH 场景下 hostname 字段决定终端是否能在远程主机重开标签（因为重新 ssh）。

规范出处: iTerm2 Proprietary Escape Codes (OSC 7) / VTE / kitty

示例

bash

# Emit on every prompt — bash 5+\nPROMPT_COMMAND='printf "\033]7;file://%s%s\007" "$HOSTNAME" "$PWD"'

python

import os, socket, sys; sys.stdout.write(f'\x1b]7;file://{socket.gethostname()}{os.getcwd()}\x07')

host, _ := os.Hostname(); wd, _ := os.Getwd(); fmt.Printf("\x1b]7;file://%s%s\x07", host, wd)

javascript

import os from 'node:os'; process.stdout.write(`\x1b]7;file://${os.hostname()}${process.cwd()}\x07`)

char host[256]; gethostname(host, sizeof host); printf("\x1b]7;file://%s%s\x07", host, getcwd(NULL, 0));

在哪里用到

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

zsh, fish, bash `__vte_prompt_command`shell 在 chpwd / PROMPT_COMMAND 钩子里发出 `\x1b]7;file://hostname/abs/path\x07` —— 让宿主终端按 shell 窗格记录 cwd，供新建标签 / 窗口操作继承
tmux `update-environment`, new-window -ctmux 从活动窗格读取 OSC 7 载荷为 `new-window` / `split-window` 设置 cwd —— `tmux new-window` 在当前 shell 目录打开，而非 tmux 的启动目录
iTerm2, Terminal.app new-tab inheritanceiTerm2 / macOS Terminal 按 Cmd-T 时，新标签在上一个标签最近一次报告的 OSC 7 cwd 打开 —— 关闭 shell_integration 后新标签回退到 `$HOME`
GNOME Terminal, Konsole, WezTerm pane-split cwdGTK / KDE / WezTerm 终端都消费 OSC 7，让 `Split Right` / `Split Down` / `Duplicate Tab` 在源窗格目录打开 —— URI 必须是 `file://host/...`，裸路径会被静默拒收
VS Code integrated terminal `Open in External Terminal`VS Code 从每个终端面板读取最新 OSC 7 —— `Terminal: Open in External Terminal` 命令以集成 shell 的 cwd 启动系统终端，而非工作区根目录

常见问题

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

怎样让新标签页继承当前 shell 的工作目录？: 让 shell 在每次 chpwd / PROMPT_COMMAND 时发 \x1b]7;file://hostname/绝对路径\x07。iTerm2、gnome-terminal、Konsole、kitty、ghostty、wezterm、Windows Terminal 都读取 OSC 7 并作为新标签 / 分屏的 cwd 使用。Zsh 的 vcs_info 样式和 starship 自动发送；bash 需要 PROMPT_COMMAND='printf "\033]7;file://%s%s\007" "$HOSTNAME" "$PWD"'。Fish 自 3.0 起原生支持。
为什么路径必须 URL 编码并带 file://，而不是裸路径？: OSC 7 由 GNOME / freedesktop 规定承载 URI 而非裸路径 —— 这样才能标识*主机*（SSH / 复用场景下终端与 shell 不在同机），并对非 ASCII / 空格做无损双向转换。发送 file://$HOSTNAME$PWD，其中 $PWD 做百分号编码。终端剥去 URI 前缀；若主机名与本机一致就本地解析 $PWD，否则退回用户家目录。

常见错写 / 易混形

开发者常从 Stack Overflow 粘贴的错误写法 —— 看起来对其实不对，附上规范的正确写法。

\x1b]7;/Users/jane/src\x07 (raw path, no scheme)\x1b]7;file:///Users/jane/src\x07 (note the *three* slashes — file:// + empty host + absolute path)
OSC 7 期望 file://HOST/PATH URL，不接受裸文件系统路径。少了 file:// 前缀，iTerm2 / Windows Terminal / kitty / wezterm / Ghostty 会静默忽略 —— 「Cmd-T 在此处新开标签」会落在 $HOME 而非当前目录。本地情形下 host 为空（所以 file:// + /Users/... 在 file: 后有三个斜杠）。bash 标准一行：PROMPT_COMMAND='printf "\033]7;file://%s%s\007" "$HOSTNAME" "$PWD"'。Apple Terminal.app 容忍两斜杠是非标准的，不可移植。
\x1b]7;file://$HOSTNAME/path with spaces/file\x07 (raw spaces in path)\x1b]7;file://$HOSTNAME/path%20with%20spaces/file\x07 (percent-encode reserved chars per RFC 3986)
OSC 7 负载是 URL，必须按 RFC 3986 百分号编码。路径里原样的空格、#、?、%、非 ASCII 字节会让终端内的 URL 解析器失败 —— kitty 静默丢弃，iTerm2 在调试日志写 Bogus URL: ...，wezterm 把标签标题设成那串残缺字符串。可移植的编码器：python3 -c 'import urllib.parse,os; print(urllib.parse.quote(os.getcwd()))'，或 zsh 内置的参数扩展。规范是 file:// URL → 必须是*合法*的 URL —— 指望「终端会自己搞定」就是在 Unicode 文件名路径上埋下静默失败的种子。
emit OSC 7 as \x1b]7;file://%s%s\x1b\\ over SSH from localhost as the hostname ($HOSTNAME unset / hostname returns localhost.localdomain)use the SSH-reachable name: printf '\033]7;file://%s%s\007' "$(hostname -f)" "$PWD" or set $HOSTNAME to the public name in ~/.ssh/rc
hostname 字段决定 iTerm2 / Windows Terminal / wezterm 中「Cmd-T 在此处新开标签」是「直接在本机同路径开 shell」还是「ssh 回远程主机后再开」。SSH 会话内发 localhost 会让终端以为 cwd 在本机，于是开一个本地 shell 指向一个不存在的路径；发空 host（file:///path）则即便人在远程也会开本地 shell。修法是始终发 SSH 可达的 FQDN：Linux 上用 $(hostname -f)、macOS 用 scutil --get HostName，或者按主机硬编码在 ~/.bashrc / ~/.zshrc。tmux 透传 OSC 7 也需同等谨慎 —— tmux 在远程，本机 iTerm2 看到远程 hostname 才能正确路由。

终端支持

xterm: 不支持
Linux console (fbcon): 不支持
macOS Terminal.app: 部分
iTerm2: 支持
Windows Terminal: 支持
cmd.exe / ConPTY: 不支持
kitty: 支持
alacritty: 部分
WezTerm: 支持
Ghostty: 支持
GNOME Terminal: 支持
Konsole: 支持
tmux: 部分
GNU screen: 不支持

xterm	Linux console (fbcon)	macOS Terminal.app	iTerm2	Windows Terminal	cmd.exe / ConPTY	kitty	alacritty	WezTerm	Ghostty	GNOME Terminal	Konsole	tmux	GNU screen
不支持	不支持	部分	支持	支持	不支持	支持	部分	支持	支持	支持	支持	部分	不支持

在家族食谱中

OSC 食谱 · 5. Shell 提示符标记 —— `OSC 133`（FinalTerm A / B / C / D）

字节形式

说明

示例

在哪里用到

相关误区

常见问题

终端支持

相关序列

在家族食谱中