在 VS Code 中尝试

代码导航

Visual Studio Code 具有高效的代码编辑器,结合编程语言服务,它能为您提供 IDE 的强大功能和文本编辑器的速度。在本主题中,我们将首先介绍 VS Code 的语言智能功能(建议、参数提示、智能代码导航),然后展示核心文本编辑器的强大功能。

快速文件导航

提示: 您可以通过键入 ⌘P (Windows, Linux Ctrl+P) (快速打开) 按名称打开任何文件。

在浏览项目时,资源管理器非常适合在文件之间导航。但是,当您执行任务时,您会发现自己快速跳转到同一组文件。VS Code 提供了两个强大的命令,可以通过易于使用的键盘快捷方式在文件内部和文件之间导航。

按住 Ctrl 并按下 Tab 可查看编辑器组中所有打开文件的列表。要打开其中一个文件,再次使用 Tab 选择要导航到的文件,然后释放 Ctrl 即可打开它。

Quick Navigation

或者,您可以使用 ⌃- (Windows Alt+Left, Linux Ctrl+Alt+-)⌃⇧- (Windows Alt+Right, Linux Ctrl+Shift+-) 在文件和编辑位置之间导航。如果您在同一文件的不同行之间跳转,这些快捷方式允许您轻松地在这些位置之间导航。

面包屑

编辑器在其内容上方有一个导航栏,称为面包屑。它显示当前位置,并允许您在文件夹、文件和符号之间快速导航。

Breadcrumbs

面包屑始终显示文件路径,并且在语言扩展的帮助下,显示光标位置处的符号路径。显示的符号与大纲视图和转到符号中的符号相同。

选择路径中的面包屑会显示一个下拉菜单,其中包含该级别的同级项,以便您可以快速导航到其他文件夹和文件。

breadcrumb folder dropdown

如果当前文件类型具有符号的语言支持,您将看到当前符号路径以及同一级别和以下级别的其他符号的下拉列表。

breadcrumb symbol dropdown

您可以使用 视图 > 显示面包屑 开关或 breadcrumbs.enabled 设置 关闭面包屑。

面包屑自定义

面包屑的外观可以自定义。如果您的路径很长,或者只对文件路径或符号路径感兴趣,您可以使用 breadcrumbs.filePathbreadcrumbs.symbolPath 设置。两者都支持 onofflast,它们定义您是否或看到路径的哪一部分。默认情况下,面包屑在面包屑左侧显示文件和符号图标,但您可以通过将 breadcrumbs.icons 设置为 false 来删除图标。

面包屑中的符号顺序

您可以通过 breadcrumbs.symbolSortOrder 设置控制面包屑下拉菜单中符号的排序方式。

允许的值为

  • position - 文件中的位置 (默认)
  • name - 字母顺序
  • type - 符号类型顺序

面包屑键盘导航

要与面包屑交互,请使用 聚焦面包屑 命令或按下 ⇧⌘. (Windows, Linux Ctrl+Shift+.)。它将选择最后一个元素并打开一个下拉菜单,允许您导航到同级文件或符号。使用 (Windows, Linux Left) (Windows, Linux Right) 键盘快捷方式转到当前元素之前或之后的元素。当下拉菜单出现时,开始输入 - 所有匹配的元素都将被突出显示,并且最佳匹配将被选中以进行快速导航。

您也可以在没有下拉菜单的情况下与面包屑交互。按下 ⇧⌘; (Windows, Linux Ctrl+Shift+;) 将焦点放在最后一个元素上,使用 (Windows, Linux Left) (Windows, Linux Right) 进行导航,并使用 Space 在编辑器中显示元素。

转到定义

如果语言支持,您可以通过按下 F12 跳转到符号的定义。

如果您按下 Ctrl 并将鼠标悬停在符号上,将出现声明的预览。

Ctrl Hover

提示: 您可以使用 Ctrl+Click 跳转到定义,或使用 Ctrl+Alt+Click 在侧边打开定义。

转到类型定义

某些语言还支持通过从编辑器上下文菜单或命令面板运行转到类型定义命令来跳转到符号的类型定义。这将带您到符号类型的定义。命令editor.action.goToTypeDefinition默认情况下未绑定到键盘快捷方式,但您可以添加自己的自定义键绑定

转到实现

语言还可以支持通过按下 ⌘F12 (Windows, Linux Ctrl+F12) 跳转到符号的实现。对于接口,这将显示该接口的所有实现者;对于抽象方法,这将显示该方法的所有具体实现。

转到符号

您可以使用 ⇧⌘O (Windows, Linux Ctrl+Shift+O) 在文件中导航符号。键入 : 后,符号将按类别分组。按下 并导航到您想要的位置。

Go to Symbol

按名称打开符号

某些语言支持使用 ⌘T (Windows, Linux Ctrl+T) 在文件之间跳转到符号。键入您要导航到的类型的第一个字母,无论它包含在哪个文件中,然后按下 Enter

Open symbol by name

速览

我们认为没有什么比当您只想快速检查一些东西时却要进行大的上下文切换更糟糕的了。这就是为什么我们支持速览编辑器。当您执行转到引用搜索(通过 ⇧F12 (Windows, Linux Shift+F12))或速览定义(通过 ⌥F12 (Windows Alt+F12, Linux Ctrl+Shift+F10))时,我们会在行内嵌入结果

Peek References

您可以在速览编辑器中导航不同的引用,并直接进行快速编辑。单击速览编辑器文件名或双击结果列表将在外部编辑器中打开引用。

提示: 此外,如果您按下 Escape 或双击速览编辑器区域,速览窗口将关闭。您可以通过 editor.stablePeek 设置 禁用此行为。

括号匹配

当光标靠近匹配括号时,它们将被突出显示。

Bracket Matching

提示: 您可以使用 ⇧⌘\ (Windows, Linux Ctrl+Shift+\) 跳转到匹配的括号。

括号对颜色化

通过将 editor.bracketPairColorization.enabled 设置为 true,匹配的括号对也可以被颜色化。

Bracket Pair Colorization

所有颜色都是可主题化的,并且最多可以配置六种颜色。

您可以使用 workbench.colorCustomizations 在您的设置中覆盖这些主题贡献的颜色。

"workbench.colorCustomizations": {
    "editorBracketHighlight.foreground1": "#FFD700",
    "editorBracketHighlight.foreground2": "#DA70D6",
    "editorBracketHighlight.foreground3": "#179fff",
},

引用信息

某些语言(例如 C#)支持行内引用信息,这些信息会实时更新。这使您能够快速分析编辑的影响或特定方法或属性在整个项目中的受欢迎程度。

Reference information

提示: 通过单击这些批注直接调用速览引用操作。

提示: CodeLens 中显示的引用信息可以通过 editor.codeLens 设置 开启或关闭。

重命名符号

某些语言支持跨文件重命名符号。按下 F2,然后输入新的所需名称并按下 Enter。符号的所有用法都将在文件中被重命名。

Rename

错误和警告

警告或错误可以通过已配置的任务、丰富的语言服务或持续在后台分析您的代码的 linter 生成。由于我们喜欢无 Bug 的代码,因此警告和错误会出现在多个位置

  • 在状态栏中,会显示所有错误和警告计数的摘要。
  • 您可以点击摘要或按下 ⇧⌘M (Windows, Linux Ctrl+Shift+M) 来显示问题面板,其中包含所有当前错误的列表。
  • 如果您打开一个有错误或警告的文件,它们将以文本的形式内联呈现并在概览标尺中显示。

errors in problems panel

提示: 要循环查看当前文件中的错误或警告,您可以按下 ⌥F8 (Windows, Linux Alt+F8)⇧⌥F8 (Windows, Linux Shift+Alt+F8),这将显示一个行内区域,详细说明问题和可能的代码操作(如果可用)

Errors and Warnings Inline

代码操作

警告和错误可以提供代码操作(也称为快速修复)以帮助解决问题。这些将作为灯泡显示在编辑器左侧的边距中。单击灯泡将显示代码操作选项或执行操作。

内嵌提示

某些语言提供内嵌提示:即以行内形式呈现的有关源代码的附加信息。这通常用于显示推断的类型。以下示例显示了内嵌提示,其中显示了 JavaScript 变量和函数返回类型的推断类型。

Inlay hints for inferred types in TypeScript

内嵌提示可以通过 editor.inlayHints.enabled 设置启用/禁用,默认情况下是启用的。需要扩展(如 TypeScript 或 Rust)才能提供实际的内嵌提示信息。

为了保护您的安全,VS Code 在从编辑器打开出站网站链接之前会显示一个提示。

Outgoing link prompt

您可以继续在浏览器中访问外部网站,也可以选择复制链接或取消请求。如果您选择 配置受信任的域,下拉菜单将允许您信任确切的 URL、信任 URL 域和子域,或信任所有域以禁用出站链接保护。

Configure Trusted Domains dropdown

管理受信任的域选项(随时也可从命令面板中获得)会显示受信任的域 JSON 文件,您可以在其中添加、删除或修改受信任的域。

// You can use the "Manage Trusted Domains" command to open this file.
// Save this file to apply the trusted domains rules.
[
  "*.twitter.com"
]

受信任的域 JSON 文件还包含带有支持的域格式示例的注释以及默认受信任的域列表,例如 https://*.visualstudio.comhttps://*.microsoft.com

后续步骤

既然您了解了编辑器的工作原理,现在该尝试一些其他功能了……

常见问题

如何在快速打开中自动选择第二个条目而不是第一个条目?

使用命令workbench.action.quickOpenPreviousEditor,您可以让快速打开中自动选择第二个条目。如果您想选择列表中的上一个条目而无需调用另一个键盘快捷方式,这会很有用

[
  {
    "key": "ctrl+p",
    "command": "workbench.action.quickOpenPreviousEditor"
  },
  {
    "key": "ctrl+p",
    "command": "-workbench.action.quickOpen"
  }
]

如何配置 Ctrl+Tab 以导航所有组的所有编辑器?

默认情况下,Ctrl+Tab 在同一编辑器组的编辑器之间导航。如果您想导航所有组中所有打开的编辑器,您可以为 workbench.action.quickOpenPreviousRecentlyUsedEditorworkbench.action.quickOpenLeastRecentlyUsedEditor 命令创建键盘快捷方式。

[
  {
    "key": "ctrl+tab",
    "command": "workbench.action.quickOpenPreviousRecentlyUsedEditor",
    "when": "!inEditorsPicker"
  },
  {
    "key": "ctrl+shift+tab",
    "command": "workbench.action.quickOpenLeastRecentlyUsedEditor",
    "when": "!inEditorsPicker"
  }
]

如何在没有选择器的情况下在最近使用的编辑器之间导航

以下是您可以在不打开选择器的情况下在编辑器中使用的命令列表:

命令 命令 ID
打开下一个最近使用的编辑器 workbench.action.openNextRecentlyUsedEditor
打开上一个使用的编辑器 workbench.action.openPreviousRecentlyUsedEditor
在组中打开下一个最近使用的编辑器 workbench.action.openNextRecentlyUsedEditorInGroup
在组中打开上一个使用的编辑器 workbench.action.openPreviousRecentlyUsedEditorInGroup