基本编辑

Visual Studio Code 首先是一个编辑器，它包含您高效进行源代码编辑所需的功能。本主题将带您了解编辑器的基本知识，并帮助您开始使用代码。

键盘快捷键

在编写代码时能够将双手放在键盘上对于提高工作效率至关重要。VS Code 具有丰富的默认键盘快捷键集，并允许您自定义它们。

• 键盘快捷键参考 - 通过下载参考表，了解最常用和流行的键盘快捷键。
• 安装键盘映射扩展 - 通过安装键盘映射扩展，在 VS Code 中使用旧编辑器（例如 Sublime Text、Atom 和 Vim）的键盘快捷键。
• 自定义键盘快捷键 - 更改默认键盘快捷键以适应您的风格。

多项选择（多光标）

VS Code 支持多光标，以便快速同时编辑。您可以使用 Alt+单击 添加辅助光标（呈现较细）。每个光标都根据其所在的位置独立操作。添加更多光标的常见方法是使用 ⌥⌘↓ (Windows Ctrl+Alt+Down, Linux Shift+Alt+Down) 或 ⌥⌘↑ (Windows Ctrl+Alt+Up, Linux Shift+Alt+Up)，它们在下方或上方插入光标。

⌘D (Windows、Linux Ctrl+D) 选择光标处的单词，或当前选择的下一个匹配项。

多光标修饰键

如果您想将应用多个光标的修饰键更改为 macOS 上的 Cmd+单击 和 Windows 和 Linux 上的 Ctrl+单击，可以使用 editor.multiCursorModifier 设置 进行更改。这允许来自其他编辑器（例如 Sublime Text 或 Atom）的用户继续使用他们熟悉的键盘修饰键。

可以将设置设置为

• ctrlCmd - 映射到 Windows 上的 Ctrl 和 macOS 上的 Cmd。
• alt - 现有的默认 Alt。

还有一个菜单项 选择 > 切换到 Ctrl+单击进行多光标 或 选择 > 切换到 Alt+单击进行多光标，以快速切换此设置。

“转到定义”和“打开链接”手势也将遵循此设置并进行调整，使其不冲突。例如，当设置是 ctrlCmd 时，可以使用 Ctrl/Cmd+单击 添加多个光标，并且可以使用 Alt+单击 调用打开链接或转到定义。

缩小/扩大选择

快速缩小或扩大当前选择。使用 ⌃⇧⌘← (Windows、Linux Shift+Alt+Left) 和 ⌃⇧⌘→ (Windows、Linux Shift+Alt+Right) 触发它。

以下是使用 ⌃⇧⌘→ (Windows、Linux Shift+Alt+Right) 扩大选择的示例

列（框）选择

将光标置于一个角，然后按住 Shift+Alt 并拖动到对角。

macOS 和 Windows 上也有列选择的默认快捷键绑定，但 Linux 上没有。

如果需要，您可以编辑您的 keybindings.json，将它们绑定到您更熟悉的内容。

列选择模式

用户设置 编辑器：列选择 控制此功能。一旦进入此模式（如状态栏中所示），默认情况下，鼠标手势和箭头键将创建列选择。此全局切换也可以通过 选择 > 列选择模式 菜单项访问。此外，还可以从状态栏禁用列选择模式。

保存/自动保存

默认情况下，VS Code 需要一个显式操作才能将更改保存到磁盘，⌘S (Windows、Linux Ctrl+S)。

不过，可以轻松启用 自动保存，它会在配置的延迟后或当焦点离开编辑器时保存你的更改。启用此选项后，无需显式保存文件。启用 自动保存 的最简单方法是使用 文件 > 自动保存 开关，该开关可以在延迟后启用或禁用保存。

要更精细地控制 自动保存，请打开用户或工作区设置并找到相关设置

• files.autoSave：可以具有以下值
  • off - 禁用自动保存。
  • afterDelay - 在配置的延迟后保存文件（默认 1000 毫秒）。
  • onFocusChange - 当焦点移出脏文件的编辑器时保存文件。
  • onWindowChange - 当焦点移出 VS Code 窗口时保存文件。
• files.autoSaveDelay：配置当 files.autoSave 配置为 afterDelay 时的延迟时间（以毫秒为单位）。默认值为 1000 毫秒。

如果你想为特定的语言或文件类型自定义 自动保存 功能，可以通过在 settings.json 文件中添加特定于语言的规则来实现。

例如，要禁用 LaTeX 文件的 自动保存

    "[latex]": {
        "files.autoSave": "off",
    },

热退出

默认情况下，VS Code 会在你退出时记住对文件的未保存更改。当应用程序通过 文件 > 退出（macOS 上为 Code > 退出）关闭或最后一个窗口关闭时，会触发热退出。

你可以通过将 files.hotExit 设置为以下值来配置热退出

• "off"：禁用热退出。
• "onExit"：当应用程序关闭时，即当 Windows/Linux 上最后一个窗口关闭或触发 workbench.action.quit 命令时（从 命令面板、键盘快捷键或菜单中），将触发热退出。所有未打开文件夹的窗口将在下次启动时恢复。
• "onExitAndWindowClose"：当应用程序关闭时，即当 Windows/Linux 上最后一个窗口关闭或触发 workbench.action.quit 命令时（从 命令面板、键盘快捷键或菜单中），以及任何打开了文件夹的窗口（无论是否为最后一个窗口）都会触发热退出。所有未打开文件夹的窗口将在下次启动时恢复。要恢复关闭前文件夹窗口的状态，请将 window.restoreWindows 设置为 all。

如果热退出出现问题，所有备份都将存储在以下标准安装位置的文件夹中

• Windows %APPDATA%\Code\Backups
• macOS $HOME/Library/Application Support/Code/Backups
• Linux $HOME/.config/Code/Backups

查找和替换

VS Code 允许你在当前打开的文件中快速查找和替换文本。按 ⌘F （Windows、Linux Ctrl+F） 打开编辑器中的“查找”小部件，搜索结果将在编辑器、概览标尺和迷你地图中突出显示。

如果当前打开的文件中有多个匹配结果，你可以按 Enter 和 ⇧Enter （Windows、Linux Shift+Enter） 在查找输入框获得焦点时导航到下一个或上一个结果。

默认情况下，VS Code 会为工作区保存查找查询的历史记录，并在重启后恢复。你可以使用 editor.find.history 设置配置此行为。将值设置为 never 可禁用保存查找历史记录。

从选择中生成搜索字符串

当打开“查找”小部件时，它会自动将编辑器中选定的文本填充到查找输入框中。如果选择为空，则会将光标下的单词插入到输入框中。

可以通过将 editor.find.seedSearchStringFromSelection 设置为 "never" 来关闭此功能。

在选定内容中查找

默认情况下，查找操作在编辑器中的整个文件上运行。它也可以在选定的文本上运行。你可以通过单击“查找”小部件上的汉堡包图标来启用此功能。

如果你希望这是“查找”小部件的默认行为，则可以将 editor.find.autoFindInSelection 设置为 always；或者，如果你希望仅在选择多行内容时在选定文本上运行，则设置为 multiline。

高级查找和替换选项

除了使用纯文本查找和替换之外，“查找”小部件还具有三个高级搜索选项

• 区分大小写
• 全字匹配
• 正则表达式

替换输入框支持保留大小写，你可以通过单击“保留大小写” (AB) 按钮来启用它。

多行支持和“查找”小部件调整大小

你可以通过将文本粘贴到“查找”输入框和“替换”输入框中来搜索多行文本。按 Ctrl+Enter 在输入框中插入新行。

在搜索长文本时，“查找”小部件的默认大小可能太小。你可以拖动左侧分隔条来放大“查找”小部件，或双击左侧分隔条来最大化它或将其缩小到默认大小。

跨文件搜索

VS Code 允许你在当前打开的文件夹中的所有文件中快速搜索。按 ⇧⌘F （Windows、Linux Ctrl+Shift+F） 并输入你的搜索词。搜索结果按包含搜索词的文件进行分组，并指示每个文件中的命中次数及其位置。展开文件以查看该文件中所有命中的预览。然后，单击其中的一个命中以在编辑器中查看它。

你可以通过单击搜索框右下方的省略号（切换搜索详细信息）（或按 ⇧⌘J （Windows、Linux Ctrl+Shift+J））来配置高级搜索选项。这将显示其他字段来配置搜索。

高级搜索选项

在搜索框下方的两个输入框中，你可以输入要在搜索中包含或排除的模式。如果你输入 example，它将匹配工作区中每个名为 example 的文件夹和文件。如果你输入 ./example，它将匹配工作区顶层的 example/ 文件夹。使用 , 分隔多个模式。路径必须使用正斜杠。你还可以使用 glob 模式语法，例如

• * 匹配路径段中的零个或多个字符
• ? 匹配路径段中的一个字符
• ** 匹配任意数量的路径段，包括无
• {} 对条件进行分组（例如 {**/*.html,**/*.txt} 匹配所有 HTML 和文本文件）
• [] **声明**要匹配的字符范围（example.[0-9] 匹配 example.0、example.1、…）
• [!...] 否定要匹配的字符范围（example.[!0-9] 匹配 example.a、example.b，但不匹配 example.0）

VS Code 默认排除某些文件夹，以减少你不感兴趣的搜索结果数量（例如：node_modules）。打开设置以在 files.exclude 和 search.exclude 部分下更改这些规则。

请注意，搜索视图中的 glob 模式与 files.exclude 和 search.exclude 等设置中的 glob 模式的工作方式不同。在设置中，你必须使用 **/example 来匹配工作区中子文件夹 folder1/example 中的名为 example 的文件夹。在“搜索”视图中，假定使用 ** 前缀。这些设置中的 glob 模式始终相对于工作区文件夹的路径进行计算。

另请注意要排除的文件框中的使用排除设置并忽略文件切换按钮。该切换确定是否排除你的 .gitignore 文件忽略的和/或与你的 files.exclude 和 search.exclude 设置匹配的文件。

搜索和替换

你还可以跨文件进行搜索和替换。展开“搜索”小部件以显示“替换”文本框。

当你在“替换”文本框中键入文本时，你将看到待处理更改的差异显示。你可以从“替换”文本框中跨所有文件进行替换，替换一个文件中的所有内容或替换单个更改。

正则表达式替换中的大小写更改

在编辑器或全局范围内进行搜索和替换时，VS Code 支持更改正则表达式匹配组的大小写。这是通过修饰符 \u\U\l\L 完成的，其中 \u 和 \l 将单个字符转换为大写/小写，而 \U 和 \L 将匹配组的其余部分转换为大写/小写。

示例

修饰符也可以堆叠使用 - 例如，\u\u\u$1 将把组的前三个字符转换为大写，或者 \l\U$1 将把第一个字符转换为小写，其余的字符转换为大写。捕获组在替换字符串中通过 $n 引用，其中 n 是捕获组的顺序。

搜索编辑器

搜索编辑器允许您在全尺寸编辑器中查看工作区搜索结果，并带有语法高亮显示和可选的周围上下文行。

下面是一个搜索“SearchEditor”的示例，匹配的前后各有两行文本作为上下文

打开搜索编辑器命令将打开一个已存在的搜索编辑器（如果存在），否则将创建一个新的。 新建搜索编辑器命令将始终创建一个新的搜索编辑器。

在搜索编辑器中，可以使用转到定义操作导航到结果，例如 F12 在当前编辑器组中打开源位置，或 ⌘K F12 (Windows, Linux Ctrl+K F12) 在侧面的编辑器中打开位置。此外，您可以使用 search.searchEditor.singleClickBehaviour 和 search.searchEditor.doubleClickBehaviour 设置配置单击或双击搜索结果的行为。例如，打开一个预览定义窗口或打开源位置。

您还可以使用搜索视图顶部的打开新的搜索编辑器按钮，并且可以使用结果树顶部的在编辑器中打开链接，或搜索编辑器：在编辑器中打开结果命令将现有搜索结果从搜索视图复制到搜索编辑器。

上面的搜索编辑器是通过选择搜索视图顶部的打开新的搜索编辑器按钮（第三个按钮）打开的。

搜索编辑器命令和参数

• search.action.openNewEditor - 在新选项卡中打开搜索编辑器。
• search.action.openInEditor - 将当前搜索结果复制到新的搜索编辑器中。
• search.action.openNewEditorToSide - 在当前打开的窗口旁边的新窗口中打开搜索编辑器。

您可以将两个参数传递给搜索编辑器命令（search.action.openNewEditor，search.action.openNewEditorToSide），以允许键盘快捷键配置新搜索编辑器的行为

• triggerSearch - 是否在打开搜索编辑器时自动运行搜索。默认为 true。
• focusResults - 将焦点放在搜索结果中还是查询输入中。默认为 true。

例如，以下键盘快捷键在打开搜索编辑器时运行搜索，但将焦点保留在搜索查询控件中。

{
  "key": "ctrl+o",
  "command": "search.action.openNewEditor",
  "args": { "query": "VS Code", "triggerSearch": true, "focusResults": false }
}

搜索编辑器上下文默认值

search.searchEditor.defaultNumberOfContextLines 设置的默认值为 1，这意味着在搜索编辑器中，每个结果行的前后都将显示一行上下文。

重用上次的搜索编辑器配置

search.searchEditor.reusePriorSearchConfiguration 设置（默认为 false）允许您在创建新的搜索编辑器时重用上次活动的搜索编辑器的配置。

IntelliSense

我们将始终提供单词补全，但对于 JavaScript、JSON、HTML、CSS、SCSS、Less、C# 和 TypeScript 等丰富的 语言，我们提供了真正的 IntelliSense 体验。如果语言服务知道可能的补全，IntelliSense 建议将在您键入时弹出。您始终可以使用 ⌃Space (Windows, Linux Ctrl+Space) 手动触发它。默认情况下，Tab 或 Enter 是接受的键盘触发器，但您也可以自定义这些键盘快捷键。

JavaScript 和 TypeScript 开发人员可以利用 npmjs 类型声明（typings）文件存储库，以获取常见 JavaScript 库（Node.js、React、Angular）的 IntelliSense。您可以在 JavaScript 语言主题和 Node.js 教程中找到关于使用类型声明文件的很好的解释。

在 IntelliSense 文档中了解更多信息。

格式化

VS Code 对源代码格式化提供了很好的支持。编辑器有两个显式格式化操作

• 格式化文档 (⇧⌥F (Windows Shift+Alt+F, Linux Ctrl+Shift+I)) - 格式化整个活动文件。
• 格式化选定内容 (⌘K ⌘F (Windows, Linux Ctrl+K Ctrl+F)) - 格式化选定的文本。

您可以从命令面板 (⇧⌘P (Windows, Linux Ctrl+Shift+P)) 或编辑器上下文菜单中调用这些命令。

VS Code 具有 JavaScript、TypeScript、JSON、HTML 和 CSS 的默认格式化程序。每种语言都有特定的格式化选项（例如，html.format.indentInnerHtml），您可以在用户或工作区 设置中根据您的偏好进行调整。如果您安装了另一个为同一语言提供格式化的扩展程序，您也可以禁用默认的语言格式化程序。

"html.format.enable": false

除了手动调用代码格式化之外，您还可以根据用户手势（如键入、保存或粘贴）触发格式化。这些默认情况下是关闭的，但您可以通过以下 设置启用这些行为

• editor.formatOnType - 键入后格式化行。
• editor.formatOnSave - 在保存时格式化文件。
• editor.formatOnPaste - 格式化粘贴的内容。

除了默认的格式化程序之外，您还可以在 Marketplace 上找到扩展程序来支持其他语言或格式化工具。有一个 Formatters 类别，因此您可以轻松地搜索和查找 格式化扩展程序。在扩展视图搜索框中，键入“formatters”或“category:formatters”以查看 VS Code 中扩展程序的筛选列表。

折叠

您可以使用行号和行开始之间的装订线上的折叠图标来折叠源代码区域。将鼠标悬停在装订线上并单击以折叠和展开区域。在折叠图标上使用 Shift + 单击 可以折叠或展开该区域以及内部的所有区域。

您还可以使用以下操作

• 折叠 (⌥⌘[ (Windows, Linux Ctrl+Shift+[)) 折叠光标处最里面的未折叠区域。
• 展开 (⌥⌘] (Windows, Linux Ctrl+Shift+])) 展开光标处的折叠区域。
• 切换折叠 (⌘K ⌘L (Windows, Linux Ctrl+K Ctrl+L)) 折叠或展开光标处的区域。
• 递归折叠 (⌘K ⌘[ (Windows, Linux Ctrl+K Ctrl+[)) 折叠光标处最里面的未折叠区域以及该区域内的所有区域。
• 递归展开 (⌘K ⌘] (Windows, Linux Ctrl+K Ctrl+])) 展开光标处的区域以及该区域内的所有区域。
• 全部折叠 (⌘K ⌘0 (Windows, Linux Ctrl+K Ctrl+0)) 折叠编辑器中的所有区域。
• 全部展开 (⌘K ⌘J (Windows, Linux Ctrl+K Ctrl+J)) 展开编辑器中的所有区域。
• 折叠级别 X (⌘K ⌘2 (Windows, Linux Ctrl+K Ctrl+2)，例如级别 2) 折叠级别 X 的所有区域，除了当前光标位置的区域。
• 折叠所有块注释 (⌘K ⌘/ (Windows, Linux Ctrl+K Ctrl+/)) 折叠所有以块注释标记开头的区域。

默认情况下，折叠区域是基于行的缩进进行评估的。当一行的缩进小于一个或多个后续行时，折叠区域开始；当出现缩进相同或更小的行时，折叠区域结束。

折叠区域也可以基于编辑器配置的语言的语法标记进行计算。以下语言已经提供了语法感知折叠：Markdown、HTML、CSS、LESS、SCSS 和 JSON。

如果您希望切换回上述一种（或全部）语言的基于缩进的折叠，请使用

  "[html]": {
    "editor.foldingStrategy": "indentation"
  },

区域还可以由每种语言定义的标记来定义。以下语言目前定义了标记

要仅折叠和展开由标记定义的区域，请使用

• 折叠标记区域 (⌘K ⌘8 (Windows, Linux Ctrl+K Ctrl+8)) 折叠所有标记区域。
• 展开标记区域 (⌘K ⌘9 (Windows, Linux Ctrl+K Ctrl+9)) 展开所有标记区域。

折叠选区

命令 从选区创建手动折叠范围 (⌘K ⌘, (Windows, Linux Ctrl+K Ctrl+,)) 从当前选定的行创建一个折叠范围并将其折叠。该范围称为 **手动** 折叠范围，它位于折叠提供程序计算的范围之上。

可以使用命令 删除手动折叠范围 (⌘K ⌘. (Windows, Linux Ctrl+K Ctrl+.)) 删除手动折叠范围。

当没有对折叠的编程语言支持时，手动折叠范围尤其有用。

缩进

VS Code 允许您控制文本缩进，以及是否希望使用空格或制表符。默认情况下，VS Code 插入空格，并且每个 Tab 键使用 4 个空格。如果您想使用其他默认值，您可以修改 editor.insertSpaces 和 editor.tabSize 设置。

    "editor.insertSpaces": true,
    "editor.tabSize": 4,

自动检测

VS Code 分析您打开的文件并确定文档中使用的缩进。自动检测到的缩进会覆盖您的默认缩进设置。检测到的设置会显示在状态栏的右侧。

您可以单击状态栏缩进显示来调出带有缩进命令的下拉菜单，允许您更改打开文件的默认设置或在制表符和空格之间进行转换。

    "editor.detectIndentation": false,
    "editor.tabSize": 3,

文件编码支持

通过在 用户设置 或 工作区设置 中使用 files.encoding 设置来全局或按工作区设置文件编码。

您可以在状态栏中查看文件编码。

单击状态栏中的编码按钮，以使用不同的编码重新打开或保存活动文件。

然后选择一种编码。

覆盖模式

VS Code 支持覆盖模式，它允许您覆盖现有字符，而不是在光标位置插入字符。默认情况下，覆盖模式处于关闭状态。

要在插入和覆盖模式之间切换，请在命令面板中运行 切换覆盖/插入模式 命令或按 (⌥⌘O (Windows, Linux Insert))。当您处于覆盖模式时，状态栏指示器会显示 OVR。

您可以通过配置 editor.overtypeCursorStyle 设置来更改覆盖模式的光标样式。

editor.overtypeOnPaste 设置使您可以使用覆盖模式粘贴文本。您需要处于覆盖模式才能使此设置生效。

比较文件

VS Code 支持多种方式来比较当前文件或任意两个文件的内容。

当您在编辑器中打开一个活动文件时，您可以使用以下比较选项

• 与工作区文件比较：在命令面板中，选择 文件: 与活动文件比较...，然后选择另一个要比较的文件。
• 与剪贴板比较：在命令面板中，选择 文件: 将活动文件与剪贴板比较 (⌘K C (Windows, Linux Ctrl+K C)) 以将当前文件与剪贴板内容进行比较。
• 与已保存的文件比较：在命令面板中，选择 文件: 将活动文件与已保存的文件比较 (⌘K D (Windows, Linux Ctrl+K D)) 以将当前文件与上次保存的版本进行比较。

要比较任意两个文件

• 在资源管理器视图中右键单击一个文件，然后选择 选择进行比较。然后，右键单击第二个文件，然后选择 与选定项比较。
• 要开始两个空编辑器窗口之间的比较，请从命令面板中选择 文件: 比较新的未命名文本文件。

后续步骤

您已经了解了基本的用户界面 - VS Code 还有更多功能。继续阅读以了解以下内容

• 入门视频 - 设置和基础知识 - 观看有关 VS Code 基础知识的教程。
• 用户/工作区设置 - 了解如何通过用户和工作区设置将 VS Code 配置为您的偏好。
• 代码导航 - 查看定义和转到定义等。
• 集成终端 - 了解用于从 VS Code 中快速执行命令行任务的集成终端。
• IntelliSense - VS Code 带来了智能代码完成。
• 调试 - 这是 VS Code 真正发光的地方。

常见问题

是否可以进行全局搜索和替换？

是的，展开搜索视图文本框以包含替换文本字段。您可以在工作区中的所有文件中搜索和替换。请注意，如果您没有在文件夹上打开 VS Code，则搜索将仅在当前打开的文件中运行。

如何打开自动换行？

您可以通过 editor.wordWrap 设置来控制自动换行。默认情况下，editor.wordWrap 为 off，但如果您将其设置为 on，文本将在编辑器的视口宽度上换行。

    "editor.wordWrap": "on"

您可以使用 ⌥Z (Windows, Linux Alt+Z) 为 VS Code 会话切换自动换行。

您还可以使用 editor.rulers 设置向编辑器添加垂直列标尺，该设置接受您希望放置垂直标尺的列字符位置数组。

与其他编辑器一样，诸如 剪切 和 复制 之类的命令适用于整个换行。三击选择整个换行。按两次 Home 将光标移动到行的开头。按两次 End 将光标移动到行的末尾。

如何避免在自动换行的行中放置额外的光标？

如果您希望在当前选定的上方或下方添加光标时忽略换行符，您可以将 { "logicalLine": true } 传递给键绑定的 args，如下所示

{
  "key": "shift+alt+down",
  "command": "editor.action.insertCursorBelow",
  "when": "textInputFocus",
  "args": { "logicalLine": true },
},
{
  "key": "shift+alt+up",
  "command": "editor.action.insertCursorAbove",
  "when": "textInputFocus",
  "args": { "logicalLine": true },
},