代码导航

Visual Studio Code 具有高生产力的代码编辑器，当与编程语言服务结合使用时，它既具有 IDE 的强大功能，又具有文本编辑器的速度。在本主题中，我们将首先介绍 VS Code 的语言智能功能（建议、参数提示、智能代码导航），然后展示核心文本编辑器的强大功能。

快速文件导航

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

当您探索项目时，资源管理器非常适合在文件之间导航。但是，当您处理任务时，您会发现自己经常在同一组文件之间快速跳转。VS Code 提供了两个强大的命令，可通过易于使用的按键绑定在文件内和跨文件进行导航。

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

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

面包屑

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

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

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

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

您可以使用“视图” > “显示面包屑”切换或使用 breadcrumbs.enabled 设置 来关闭面包屑。

面包屑自定义

可以自定义面包屑的外观。如果您的路径非常长，或者您只对文件路径或符号路径感兴趣，则可以使用 breadcrumbs.filePath 和 breadcrumbs.symbolPath 设置。两者都支持 on、off 和 last，它们定义您看到路径的哪个部分或什么部分。默认情况下，面包屑在面包屑的左侧显示文件和符号图标，但您可以通过将 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+单击跳转到定义，或使用 Ctrl+Alt+单击在侧面打开定义。

转到类型定义

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

转到实现

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

转到符号

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

按名称打开符号

某些语言支持使用⌘T (Windows, Linux Ctrl+T)跳转到跨文件的符号。输入你想导航到的类型的首字母，无论它在哪个文件中，然后按下Enter键。

速览

我们认为，当你想快速检查某些内容时，最糟糕的事情莫过于进行大型的上下文切换。这就是我们支持“预览编辑器”的原因。当你执行转到引用搜索（通过⇧F12 (Windows, Linux Shift+F12)）或预览定义（通过⌥F12 (Windows Alt+F12, Linux Ctrl+Shift+F10)）时，我们会将结果嵌入到内联中。

你可以在预览编辑器中在不同的引用之间导航，并在那里进行快速编辑。单击预览编辑器的文件名或双击结果列表将在外部编辑器中打开引用。

提示：此外，如果按下Escape键或在预览编辑器区域中双击，预览窗口将关闭。你可以使用editor.stablePeek设置禁用此行为。

括号匹配

当光标靠近其中一个括号时，匹配的括号将立即突出显示。

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

括号对颜色化

通过将editor.bracketPairColorization.enabled设置为true，也可以对匹配的括号对进行着色。

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

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

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

参考信息

某些语言（如 C#）支持内联引用信息，该信息会实时更新。这使你可以快速分析编辑的影响或你的特定方法或属性在整个项目中的受欢迎程度

提示：通过单击这些注释直接调用预览引用操作。

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

重命名符号

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

错误和警告

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

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

提示：要循环浏览当前文件中的错误或警告，你可以按⌥F8 (Windows, Linux Alt+F8)或⇧⌥F8 (Windows, Linux Shift+Alt+F8)，这将显示一个内联区域，详细说明问题和可能的代码操作（如果可用）

代码操作

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

内联提示

某些语言提供嵌入提示：即内联呈现的有关源代码的附加信息。这通常用于显示推断的类型。下面的示例显示了嵌入提示，该提示显示了 JavaScript 变量和函数返回类型的推断类型。

可以使用editor.inlayHints.enabled设置启用/禁用嵌入提示，默认情况下启用。需要诸如 TypeScript 或 Rust 之类的扩展来提供实际的嵌入提示信息。

传出链接保护

为了保护你的安全，VS Code 在从编辑器打开外发网站链接之前会显示提示。

你可以继续在浏览器中访问外部网站，或者选择复制链接或取消请求。如果选择配置受信任的域，则下拉列表允许你信任确切的 URL、信任 URL 域和子域或信任所有域以禁用外发链接保护。

管理受信任的域选项也可以随时从命令面板中使用，它会打开 受信任的域 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.com 和 https://*.microsoft.com。

后续步骤

现在你已经了解了编辑器的工作原理，是时候尝试其他一些内容了...

• 入门视频 - 代码编辑 - 观看有关代码编辑功能的入门视频。
• 用户界面 - 如果你错过了有关 VS Code 的基本方向指导。
• 键绑定 - 了解如何根据你的喜好修改键绑定。
• 调试 - 这是 VS Code 真正闪光的地方。

常见问题

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

使用命令 workbench.action.quickOpenPreviousEditor，你可以让快速打开中的第二个条目被自动选中。如果你想从列表中选择上一个条目而不必调用另一个键绑定，这将非常有用

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

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

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

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

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

这是你可以用来在编辑器中导航而无需打开选择器的命令列表