代码导航
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+Click 跳转到定义,或使用 Ctrl+Alt+Click 在侧边打开定义。
转到类型定义
某些语言还支持通过从编辑器上下文菜单或命令面板运行转到类型定义命令来跳转到符号的类型定义。这将带您到符号类型的定义处。editor.action.goToTypeDefinition
命令默认没有绑定到键盘快捷键,但您可以添加自己的自定义键位绑定。
转到实现
语言还可以支持通过按 ⌘F12 (Windows, Linux Ctrl+F12) 跳转到符号的实现。对于一个接口,这将显示该接口的所有实现者;对于抽象方法,这将显示该方法的所有具体实现。
转到符号
您可以使用 ⇧⌘O (Windows, Linux Ctrl+Shift+O) 在文件内导航符号。通过输入 :,符号将按类别分组。按 Up 或 Down 导航到您想要的位置。
按名称打开符号
某些语言支持使用 ⌘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 生成。由于我们热爱无 bug 的代码,警告和错误会出现在多个地方。
- 在状态栏中,有所有错误和警告数量的摘要。
- 您可以点击该摘要或按 ⇧⌘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"
}
]
如何在不使用选择器的情况下在最近使用的编辑器之间导航?
这里是一个命令列表,您可以使用它们在编辑器之间导航而无需打开选择器:
键 | 命令 | 命令 ID |
---|---|---|
打开下一个最近使用的编辑器 | workbench.action.openNextRecentlyUsedEditor |
|
打开上一个使用过的编辑器 | workbench.action.openPreviousRecentlyUsedEditor |
|
打开组内下一个最近使用的编辑器 | workbench.action.openNextRecentlyUsedEditorInGroup |
|
打开组内上一个使用过的编辑器 | workbench.action.openPreviousRecentlyUsedEditorInGroup |