🚀 在 VS Code 中

终端高级

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:始终隐藏终端,即使恢复了持久会话。

键盘快捷键和 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+左箭头),然后按 退格键

{
  "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 设置启用。

当前限制

进程环境

在终端中运行的应用程序的进程环境受各种设置和扩展的影响,可能导致 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 使用 Console API 来实现其名为“conhost”的控制台。

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

VS Code 默认在 Windows 10+(从内部版本号 18309 开始)上使用 ConPTY,并回退到 winpty 作为旧版 Windows 版本的选项。ConPTY 可以通过 terminal.integrated.windowsEnableConpty 设置显式禁用,但通常应避免这样做。

由于 ConPTY 是一个模拟层,因此它确实带有一些怪癖。最常见的是 ConPTY 认为自己是视口的拥有者,因此有时会重新打印屏幕。这种重新打印可能会导致意外行为,例如在运行 终端:清除 命令后显示旧内容。

远程开发

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

减少远程输入延迟

本地回显是一项功能,可帮助缓解输入延迟对远程窗口的影响。它以灰色颜色在终端中写入击键,然后再由远程端确认结果。默认情况下,当检测到延迟高于 30 毫秒时,该功能开始运行,并且可以使用 terminal.integrated.localEchoLatencyThreshold 配置时序。未确认字符的颜色由 terminal.integrated.localEchoStyle 定义。

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

要完全禁用该功能,请使用

{
  "terminal.integrated.localEchoEnabled": false
}

远程窗口中的本地终端

默认的本地终端配置文件可以使用命令面板中的 终端:创建新的集成终端(本地) 命令在远程窗口中启动。目前,非默认配置文件无法从远程窗口启动。