扩展能力概览
Visual Studio Code 提供了多种方式让扩展来扩展其功能。有时可能很难找到合适的贡献点和VS Code API来使用。本主题将扩展功能分为几类。每类描述
- 你的扩展可以使用的一些功能
- 有关使用这些功能的更详细主题的链接
- 一些扩展想法
但是,为了确保 VS Code 的稳定性和性能,我们对扩展也施加了限制。例如,扩展不能访问 VS Code UI 的 DOM。
通用能力
通用能力是可在任何扩展中使用的核心功能。
其中一些功能包括
- 注册命令、配置、快捷键或上下文菜单项。
- 存储工作区或全局数据。
- 显示通知消息。
- 使用快速选择(Quick Pick)收集用户输入。
- 打开系统文件选择器,让用户选择文件或文件夹。
- 使用进度 API 来指示长时间运行的操作。
主题化
主题化控制 VS Code 的外观,包括编辑器中源代码的颜色和 VS Code UI 的颜色。如果你曾想通过将 VS Code 设置成不同深浅的绿色,使其看起来像在编写《黑客帝国》代码,或者只是想创建一个极致、极简的灰度工作区,那么主题就是为你准备的。
扩展想法
- 更改源代码的颜色。
- 更改 VS Code UI 的颜色。
- 将现有 TextMate 主题移植到 VS Code。
- 添加自定义文件图标。
声明式语言特性
声明式语言特性为编程语言添加了基本的文本编辑支持,例如括号匹配、自动缩进和语法高亮。这是以声明方式完成的,无需编写任何代码。有关更高级的语言特性,如智能感知(IntelliSense)或调试,请参阅编程式语言特性。
扩展想法
- 将常见 JavaScript 代码片段打包到扩展中。
- 告知 VS Code 一种新的编程语言。
- 添加或替换编程语言的语法。
- 通过语法注入扩展现有语法。
- 将现有 TextMate 语法移植到 VS Code。
编程式语言特性
编程式语言特性添加了丰富的编程语言支持,例如悬停(Hovers)、转到定义(Go to Definition)、诊断错误、智能感知(IntelliSense)和 CodeLens。这些语言特性通过vscode.languages.*
API 公开。扩展可以直接使用这些 API,也可以编写一个语言服务器(Language Server)并使用 VS Code 语言服务器库将其适配到 VS Code。
尽管我们提供了语言特性及其预期用法的列表,但没有什么能阻止你创造性地使用这些 API。例如,CodeLens 和悬停(Hovers)是内联呈现附加信息的好方法,而诊断错误可用于突出显示拼写或代码样式错误。
扩展想法
- 添加悬停提示,显示 API 的示例用法。
- 使用诊断功能报告源代码中的拼写或 Linter 错误。
- 为 HTML 注册一个新的代码格式化程序。
- 提供丰富、上下文感知的智能感知(IntelliSense)。
- 为语言添加折叠、面包屑和大纲支持。
工作台扩展
工作台扩展扩展了 VS Code 工作台 UI。你可以向文件资源管理器添加新的右键单击操作,甚至使用 VS Code 的树视图(TreeView) API 构建自定义资源管理器。如果你的扩展需要一个完全自定义的用户界面,请使用 Webview API 使用标准的 HTML、CSS 和 JavaScript 构建你自己的文档预览或 UI。
扩展想法
- 向文件资源管理器添加自定义上下文菜单操作。
- 在侧边栏中创建一个新的交互式树视图(TreeView)。
- 定义一个新的活动栏视图。
- 在状态栏中显示新信息。
- 使用
WebView
API 渲染自定义内容。 - 贡献源代码管理提供者。
调试
通过编写将 VS Code 调试 UI 连接到特定调试器或运行时的调试器扩展,你可以利用 VS Code 的调试功能。
扩展想法
- 通过贡献调试适配器实现,将 VS Code 的调试 UI 连接到调试器或运行时。
- 指定调试器扩展支持的语言。
- 为调试器使用的调试配置属性提供丰富的智能感知(IntelliSense)和悬停信息。
- 提供调试配置代码片段。
另一方面,VS Code 还提供了一套调试扩展 API,通过它可以实现任何 VS Code 调试器之上的调试相关功能,以自动化用户的调试体验。
扩展想法
- 根据动态创建的调试配置启动调试会话。
- 跟踪调试会话的生命周期。
- 以编程方式创建和管理断点。
用户体验指南
为了帮助你的扩展无缝融入 VS Code 用户界面,请参阅用户体验指南,你将在其中学习创建扩展 UI 的最佳实践以及遵循首选 VS Code 工作流程的约定。
限制
我们对扩展施加了某些限制。以下是这些限制及其目的。
无 DOM 访问权限
扩展无权访问 VS Code UI 的 DOM。你无法编写一个对 VS Code 应用自定义 CSS 或向 VS Code UI 添加 HTML 元素的扩展。
在 VS Code 中,我们不断尝试优化底层 Web 技术的使用,以提供一个始终可用、高度响应的编辑器,并且随着这些技术和我们产品的演进,我们将继续调整对 DOM 的使用。为确保扩展不会干扰 VS Code 的稳定性和性能,并且我们可以在不破坏现有扩展的情况下继续改进 VS Code 的 DOM,我们将扩展运行在扩展宿主进程中,并阻止直接访问 DOM。
无自定义样式表
用户或扩展提供的自定义样式表将与 DOM 结构和类名相悖。这些内容没有文档说明,因为我们将其视为内部实现。为了演进、重构或改进 VS Code,我们需要自由地对用户界面进行更改。对 DOM 的任何更改都可能破坏现有的自定义样式表,从而给样式表提供者带来困扰,并导致因损坏的样式表而出现 UI 故障,造成糟糕的用户体验。
相反,VS Code 旨在提供一个设计良好的扩展 API,支持 UI 自定义。该 API 有完善的文档,附带工具和示例,并在 VS Code 的所有未来版本中保持稳定。