终端高级

Visual Studio Code 的集成终端有许多高级功能和设置，例如 Unicode 和 emoji 支持、自定义键盘快捷方式和自动回复。本主题详细解释了这些高级功能。如果您刚开始使用 VS Code 或集成终端，建议您首先查看终端基础主题。

持久化会话

终端支持两种不同类型的持久化会话：

进程重新连接：重新加载窗口（例如，安装扩展后）时，重新连接到上一个进程并恢复其内容。
进程恢复：重启 VS Code 时，终端内容会恢复，并且进程会使用其原始环境重新启动。

可以通过将 terminal.integrated.enablePersistentSessions 设置为 false 来禁用这两种持久化会话，恢复的滚动回退量由 terminal.integrated.persistentSessionScrollback 设置控制。进程恢复可以独立地通过 terminal.integrated.persistentSessionReviveProcess 进行配置。

在窗口之间移动终端

终端选项卡可以在 VS Code 窗口之间拖放。也可以通过命令面板以及终端：分离会话和终端：附加到会话命令手动完成。

配置终端可见性

打开窗口时，如果终端视图可见，它会使用持久化会话重新连接到终端，或创建一个新的 shell。此行为可以通过 terminal.integrated.hideOnStartup 设置进行微调。

never（默认）：启动时从不隐藏终端视图。
whenEmpty：仅当没有恢复的持久化会话时隐藏终端。
always：始终隐藏终端，即使有恢复的持久化会话。

terminal.integrated.hideOnLastClosed 设置也可用于覆盖在最后一个终端关闭时关闭终端视图的默认行为。

键盘快捷方式和 shell

作为嵌入式应用程序，集成终端应拦截 VS Code 中分派的部分（但不是全部）键盘快捷方式。

可配置的 terminal.integrated.commandsToSkipShell 设置确定哪些命令的键盘快捷方式应始终“跳过 shell”而由 VS Code 的键盘快捷方式系统处理。默认情况下，它包含 VS Code 体验不可或缺的硬编码命令列表，但您可以添加或删除特定命令

{
  "terminal.integrated.commandsToSkipShell": [
    // Ensure the toggle sidebar visibility keyboard shortcut skips the shell
    "workbench.action.toggleSidebarVisibility",
    // Send quick open's keyboard shortcut to the shell
    "-workbench.action.quickOpen",
  ]
}

查看 terminal.integrated.commandsToSkipShell 设置详细信息以查看默认命令的完整列表。

提示：可以配置 terminal.integrated.sendKeybindingsToShell 来覆盖 terminal.integrated.commandsToSkipShell 并将大多数键盘快捷方式分派给 shell。请注意，这会禁用诸如 Ctrl+F 之类的键盘快捷方式来打开查找。

组合键

组合键键盘快捷方式由两个键盘快捷方式组成，例如先按 Ctrl+K 再按 Ctrl+C 将行更改为注释。组合键默认始终跳过 shell，但可以通过 terminal.integrated.allowChords 禁用。

macOS 清屏

在 macOS 上，Cmd+K 是终端中常用的清屏键盘快捷方式，因此 VS Code 也遵循此习惯，这意味着 Cmd+K 组合键将不起作用。Cmd+K 组合键可以通过删除清屏键盘快捷方式启用。

{
  "key": "cmd+k",
  "command": "-workbench.action.terminal.clear"
}

此外，如果任何扩展贡献了 Cmd+K 键盘快捷方式，由于键盘快捷方式优先级的工作方式，此键盘快捷方式将被自动覆盖。在这种情况下，要重新启用 Cmd+K 清屏键盘快捷方式，您可以在用户键盘快捷方式中重新定义它，用户键盘快捷方式具有比扩展键盘快捷方式更高的优先级。

{
  "key": "cmd+k",
  "command": "workbench.action.terminal.clear",
  "when": "terminalFocus && terminalHasBeenCreated || terminalFocus && terminalProcessSupported"
}

助记符

使用助记符访问 VS Code 菜单（例如，Alt+F 用于文件菜单）在终端中默认禁用，因为这些按键事件通常是 shell 中的重要热键。设置 terminal.integrated.allowMnemonics 以启用助记符，但请注意，这将阻止任何 Alt 键事件发送到 shell。此设置在 macOS 上不起作用。

自定义序列键盘快捷方式

workbench.action.terminal.sendSequence 命令可用于向终端发送特定的文本序列，包括 shell 特别解释的转义序列。该命令使您能够发送方向键、Enter、光标移动等。

例如，下面的序列会跳过光标左侧的单词（Ctrl+Left），然后按下 Backspace

{
  "key": "ctrl+u",
  "command": "workbench.action.terminal.sendSequence",
  "args": {
    "text": "\u001b[1;5D\u007f"
  }
}

此功能支持变量替换。

sendSequence 命令仅支持使用字符码通过 \u0000 格式（而不是 \x00）使用字符。在以下资源中了解有关这些十六进制码和终端序列的更多信息：

确认对话框

为了避免不必要的输出和用户提示，进程退出时终端不显示警告对话框。如果需要警告，可以通过以下设置配置：

terminal.integrated.confirmOnExit - 控制在有活动调试会话时，窗口关闭时是否进行确认。
terminal.integrated.confirmOnKill - 控制在终端有子进程时是否确认终止终端。
terminal.integrated.showExitAlert - 控制在退出码非零时是否显示警报“终端进程已终止，退出码为”。

自动回复

如果在收到精确的输出序列时，终端可以自动向 shell 提供可配置的输入响应。最常见的用例是在批处理脚本中按下 Ctrl+C 时自动回复提示，该脚本询问用户是否要终止批处理作业。要自动忽略此消息，请添加此设置：

{
  "terminal.integrated.autoReplies": {
    "Terminate batch job (Y/N)": "Y\r"
  }
}

请注意，此处使用的 \r 字符表示 Enter，并且很像自定义序列键盘快捷方式，此功能支持向 shell 发送转义序列。

默认情况下未配置自动回复，因为提供 shell 输入应由用户明确操作或配置。

更改制表位宽度

terminal.integrated.tabStopWidth 设置允许配置在终端中运行的程序输出 \t 时的制表位宽度。通常不需要此设置，因为程序通常会移动光标而不是使用 Tab 字符，但在某些情况下可能有用。

Unicode 和 emoji 支持

终端支持 Unicode 和 emoji。在终端中使用这些字符时，存在一些注意事项：

某些 Unicode 符号具有不明确的宽度，在不同的 Unicode 版本之间可能会发生变化。当前我们支持 Unicode 版本 6 和 11 的宽度，这可以通过 terminal.integrated.unicodeVersion 设置进行配置。指定的版本应与 shell/操作系统使用的 Unicode 版本匹配，否则可能出现渲染问题。请注意，shell/操作系统的 Unicode 版本可能与字体的实际宽度不匹配。
由多个字符组成的部分 emoji 可能无法正确渲染，例如，肤色修饰符。
Windows 上的 emoji 支持有限。

图片支持

如果终端中的图片使用 Sixel 或 iTerm 内联图片协议，则它们可以工作。此功能默认禁用，可以通过 terminal.integrated.enableImages 设置启用。

当前限制

序列化不起作用，因此重新加载终端将不会保留任何图片（jerch/xterm-addon-image#47）。
将选择内容复制为 HTML 不包含选定的图片（jerch/xterm-addon-image#50）。
动图（GIF）不起作用（jerch/xterm-addon-image#51）。
比单元格短的图片无法正常工作，这是序列的设计缺陷，也发生在 XTerm 中。

进程环境

在终端中运行的应用程序的进程环境受各种设置和扩展的影响，这可能导致 VS Code 终端中的输出看起来与其他终端不同。

环境继承

打开 VS Code 时，它会启动登录 shell 环境以获取 shell 环境。这样做是因为开发工具经常添加到 shell 启动脚本（例如 ~/.bash_profile）中的 $PATH。默认情况下，终端会继承此环境，具体取决于您的配置文件 shell 参数，这意味着可能运行了多个配置文件脚本，从而可能导致意外的行为。

可以在 macOS 和 Linux 上通过 terminal.integrated.inheritEnv 设置禁用此环境继承。

与 `$LANG` 的交互

与 $LANG 环境变量有一些特殊的交互，它决定了字符在终端中的呈现方式。此功能通过 terminal.integrated.detectLocale 设置进行配置：

值	行为
`on`	始终将 `$LANG` 设置为最常用的值。所选值基于操作系统区域设置（回退到 `en-US`）并使用 UTF-8 编码。
`auto`（默认）	如果 `$LANG` 未正确配置（未设置为 UTF 或 EUC 编码），则将 `$LANG` 设置为类似于 `on` 的行为。
`off`	不修改 `$LANG`。

扩展环境贡献

扩展能够贡献到终端环境，从而提供与终端的一些集成。例如，内置的 Git 扩展会注入 GIT_ASKPASS 环境变量，以允许 VS Code 处理到 Git 远程仓库的身份验证。

如果扩展更改了终端环境，如果安全，则会重新启动任何现有终端，否则将在终端状态中显示警告。可以在悬停窗口中查看有关更改的更多信息，其中也包含重新启动按钮。

A warning icon appears next to the terminal tab when a relaunch is required, information on the changes can be viewed by hovering it

Windows 和 ConPTY

VS Code 的终端基于 xterm.js 项目构建，以实现 Unix 风格的终端，该终端将所有数据序列化为字符串并通过“伪终端”传输。历史上，这不是终端在 Windows 上的工作方式，Windows 使用控制台 API 实现其名为“conhost”的控制台。

创建了一个名为 winpty 的开源项目，试图通过在 Unix 风格终端和 Windows 控制台之间提供仿真/转换层来解决此问题。VS Code 的终端最初仅使用 winpty 实现。这在当时很棒，但在 2018 年，Windows 10 引入了 ConPTY API，该 API 采用了 winpty 开创的思想并将其内置到 Windows 中，提供了一个更可靠且受支持的系统，以便在 Windows 上利用 Unix 风格的终端和应用程序。

VS Code 在 Windows 10+（从构建号 18309 开始）上默认为 ConPTY，并回退到 winpty 作为旧版 Windows 的遗留选项。ConPTY 可以通过 terminal.integrated.windowsEnableConpty 设置显式禁用，但通常应避免这样做。

由于 ConPTY 是一个仿真层，它确实有一些怪癖。最常见的是 ConPTY 将自身视为视口所有者，因此有时会重新打印屏幕。这种重新打印可能导致意外行为，例如在运行终端：清除命令后显示旧内容。

远程开发

本节概述了使用 VS Code 远程开发扩展连接到远程计算机时的特定主题。

远程窗口中的本地终端

默认的本地终端配置文件可以通过命令面板中的终端：创建新集成终端 (本地) 命令在远程窗口中启动。当前，无法从远程窗口启动非默认配置文件。

减少远程输入延迟（预览）

本地回显是一个有助于减轻远程窗口输入延迟的功能。它在远程确认结果之前，在终端中以暗淡的颜色写入击键。默认情况下，当检测到延迟高于 30 毫秒时，此功能开始运行，并且可以通过 terminal.integrated.localEchoLatencyThreshold 配置时间。未确认字符的颜色由 terminal.integrated.localEchoStyle 定义。

本地回显会根据终端中的活动程序动态禁用自身。这由 terminal.integrated.localEchoExcludePrograms 控制，该设置默认为 ['vim', 'vi', 'nano', 'tmux']。建议您对任何高度动态和/或在键入时大量重新打印屏幕的应用程序或 shell 禁用此功能。

要完全禁用此功能，请使用：

{
  "terminal.integrated.localEchoEnabled": false
}

05/08/2025