基本编辑

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 和 editor.find.replaceHistory 设置来配置此行为。将值设置为 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 - 格式化粘贴的内容。

除了默认格式化程序之外，您还可以在市场中找到支持其他语言或格式化工具的扩展。有一个 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"
  },

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

TypeScript/JavaScript

• //#region
• //#endregion

Visual Basic

#Region

#End Region

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

缩进

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

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

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

折叠选区

命令 从选区创建手动折叠范围 (⌘K ⌘, (Windows, Linux Ctrl+K Ctrl+,)) 从当前选中的行创建折叠范围并折叠它。该范围称为手动折叠范围，它会覆盖由折叠提供程序计算出的范围。

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

文件编码支持

在编程语言没有折叠支持的情况下，手动折叠范围特别有用。

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

自动检测

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

覆盖模式

您可以点击状态栏中的缩进显示，打开一个包含缩进命令的下拉菜单，允许您更改当前打开文件的默认设置，或在制表符和空格之间进行转换。

VS Code 自动检测会检查 2、4、6 或 8 个空格的缩进。如果您的文件使用了不同数量的空格，缩进可能无法正确检测。例如，如果您的习惯是用 3 个空格缩进，您可能希望关闭 editor.detectIndentation 并明确地将制表符大小设置为 3。

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

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

点击状态栏中的编码按钮，可以使用不同的编码重新打开或保存当前文件。

比较文件

然后选择一个编码。

在 1.96 版本之前，VS Code 只支持插入模式，在该模式下，字符插入在光标位置，除非您安装了 Vim 键盘映射扩展。

• 从 1.96 版本开始，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)) 比较当前文件与最后一次保存的版本。
• 比较任意两个文件：
• 在资源管理器视图中右键单击文件，然后选择 选择以进行比较。接着，右键单击第二个文件，并选择 与选中项比较。
• 要在两个空的编辑器窗口之间开始比较，请从命令面板中选择 文件: 比较新的无标题文本文件。
• 您可以使用 --diff 选项从命令行启动 VS Code 以比较两个文件。了解有关 VS Code 命令行界面的更多信息。
• 您已经了解了基本用户界面 - VS Code 还有很多功能。继续阅读以了解以下内容：

常见问题

入门视频 - 设置和基础 - 观看 VS Code 基础教程。

用户/工作区设置 - 了解如何通过用户和工作区设置根据您的偏好配置 VS Code。

代码导航 - 查看、转到定义等。

集成终端 - 了解如何在 VS Code 中使用集成终端快速执行命令行任务。

    "editor.wordWrap": "on"

IntelliSense - VS Code 提供智能代码补全。

调试 - 这是 VS Code 真正出彩之处。

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

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

如何开启自动换行？

{
  "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 },
},