VS Code API

当认证提供者的认证会话被添加、移除或更改时触发的事件。

获取用户登录到指定提供商的所有账户。 将此与getSession结合使用，以获取特定账户的认证会话。

目前，只有两个认证提供者是由内置扩展贡献给编辑器的，它们实现了GitHub和Microsoft认证：它们的providerId分别是'github'和'microsoft'。

注意：获取账户并不意味着您的扩展程序可以访问该账户或其认证会话。您可以通过调用getSession来验证对账户的访问权限。

获取与所需范围匹配的认证会话。如果未注册具有providerId的提供程序，或者用户不同意与扩展共享认证信息，则拒绝。如果有多个具有相同范围的会话，将向用户显示一个快速选择器，以选择他们想要使用的帐户。

目前，只有两个认证提供者是由内置扩展贡献给编辑器的，它们实现了GitHub和Microsoft认证：它们的providerId分别是'github'和'microsoft'。

获取与所需范围匹配的认证会话。如果未注册具有providerId的提供程序，或者用户不同意与扩展共享认证信息，则拒绝。如果有多个具有相同范围的会话，将向用户显示一个快速选择器，以选择他们想要使用的帐户。

目前，只有两个认证提供者是由内置扩展贡献给编辑器的，它们实现了GitHub和Microsoft认证：它们的providerId分别是'github'和'microsoft'。

获取与所需范围匹配的认证会话。如果未注册具有providerId的提供程序，或者用户不同意与扩展共享认证信息，则拒绝。如果有多个具有相同范围的会话，将向用户显示一个快速选择器，以选择他们想要使用的帐户。

目前，只有两个认证提供者是由内置扩展贡献给编辑器的，它们实现了GitHub和Microsoft认证：它们的providerId分别是'github'和'microsoft'。

注册一个认证提供者。

每个ID只能有一个提供者，当某个ID已被另一个提供者使用时，会抛出错误。ID区分大小写。

创建一个新的聊天参与者实例。

执行由给定命令标识符表示的命令。

• 注意 1: 执行编辑器命令时，并非所有类型都可以作为参数传递。允许的类型包括基本类型 string, boolean, number, undefined, 和 null, 以及 Position, Range, Uri 和 Location。
• 注意 2: 执行由扩展贡献的命令时没有任何限制。

检索所有可用命令的列表。以下划线开头的命令被视为内部命令。

注册一个可以通过键盘快捷键、菜单项、操作或直接调用的命令。

使用现有命令标识符注册命令两次将导致错误。

注册一个可以通过键盘快捷键、菜单项、操作或直接调用的文本编辑器命令。

文本编辑器命令与普通的命令不同，因为它们仅在调用命令时存在活动编辑器时执行。此外，编辑器命令的处理程序可以访问活动编辑器和编辑构建器。请注意，编辑构建器仅在回调执行期间有效。

创建一个新的评论控制器实例。

当前活动的调试控制台。 如果没有活动的调试会话，发送到调试控制台的输出将不会显示。

当前活动的调试会话或undefined。活动的调试会话是由调试操作浮动窗口表示的会话，或者是当前显示在调试操作浮动窗口下拉菜单中的会话。如果没有活动的调试会话，则值为undefined。

当前聚焦的线程或堆栈帧，如果没有聚焦的线程或堆栈，则为undefined。当有活动的调试会话时，线程可以随时聚焦，而堆栈帧只能在会话暂停并且调用堆栈已检索时聚焦。

断点列表。

当活动调试会话发生变化时触发的事件。注意，当活动调试会话变为undefined时，该事件也会触发。

当debug.activeStackItem发生变化时触发的事件。

当断点集合被添加、移除或更改时发出的事件。

当从调试会话接收到自定义DAP事件时触发的事件。

当一个新的调试会话开始时触发的事件。

当调试会话终止时触发的事件。

添加断点。

将通过调试适配器协议接收的“Source”描述符对象转换为可用于加载其内容的Uri。 如果源描述符基于路径，则返回文件Uri。 如果源描述符使用引用号，则构建一个特定的调试Uri（方案'debug'），该Uri需要相应的ContentProvider和正在运行的调试会话

如果“Source”描述符没有足够的信息来创建Uri，则会抛出错误。

为特定的调试类型注册一个调试适配器描述符工厂。 扩展程序只能为其定义的调试类型注册DebugAdapterDescriptorFactory。否则会抛出错误。 为一个调试类型注册多个DebugAdapterDescriptorFactory会导致错误。

为给定的调试类型注册一个调试适配器跟踪器工厂。

为特定的调试类型注册一个调试配置提供者。 可选的triggerKind可用于指定提供者的provideDebugConfigurations方法何时被触发。 目前有两种触发类型：当值为Initial（或未提供触发类型参数）时，provideDebugConfigurations方法用于提供初始调试配置，这些配置将被复制到新创建的launch.json中。 当触发类型为Dynamic时，provideDebugConfigurations方法用于动态确定要呈现给用户的调试配置（除了来自launch.json的静态配置之外）。 请注意，triggerKind参数仅适用于provideDebugConfigurations方法：因此resolveDebugConfiguration方法完全不受影响。 为不同的触发类型注册一个具有解析方法的提供者，会导致相同的解析方法被多次调用。 可以为同一类型注册多个提供者。

移除断点。

通过使用命名的启动或命名的复合配置开始调试，或者直接传递一个DebugConfiguration。命名的配置在给定文件夹中的'.vscode/launch.json'中查找。在调试开始之前，所有未保存的文件都会被保存，并且启动配置会被更新为最新状态。配置中使用的文件夹特定变量（例如'${workspaceFolder}'）会根据给定文件夹进行解析。

停止给定的调试会话，如果省略会话，则停止所有调试会话。

应用程序的托管位置 在桌面上，这是'desktop' 在网页上，这是指定的嵌入器，即'github.dev'、'codespaces'，如果嵌入器未提供该信息，则为'web'

编辑器的应用程序名称，例如 'VS Code'。

编辑器运行的应用程序根文件夹。

注意，在没有应用程序根文件夹表示的环境中运行时，该值为空字符串。

系统剪贴板。

表示这是应用程序的首次安装。 true 如果在安装的第一天内，否则为 false。

指示用户是否启用了遥测功能。 可以观察到以确定扩展是否应发送遥测数据。

表示首选用户语言，如 de-CH、fr 或 en-US。

编辑器的当前日志级别。

计算机的唯一标识符。

远程的名称。由扩展定义，常见的示例是用于Windows子系统的wsl或使用安全外壳的远程的ssh-remote。

注意，当没有远程扩展主机时，值为undefined，但如果存在远程扩展主机，则该值在所有扩展主机（本地和远程）中都有定义。使用Extension.extensionKind来了解特定扩展是否在远程运行。

当前会话的唯一标识符。 每次启动编辑器时都会更改。

检测到的扩展主机的默认shell，这会被扩展主机平台的terminal.integrated.defaultProfile设置覆盖。请注意，在不支持shell的环境中，该值为空字符串。

UI kind 属性指示从哪个 UI 扩展访问。例如，扩展可以从桌面应用程序或网页浏览器访问。

编辑器在操作系统中注册的自定义URI方案。

当编辑器的日志级别发生变化时触发的事件。

当默认 shell 更改时触发的 Event。此事件会携带新的 shell 路径。

当用户启用或禁用遥测时触发的事件。 true 如果用户启用了遥测，或 false 如果用户禁用了遥测。

将URI解析为可从外部访问的形式。

http: 或 https: 方案

解析一个外部 URI，例如从扩展运行的http:或https:链接，到客户端机器上相同资源的URI。

如果扩展在客户端机器上运行，则这是一个无操作。

如果扩展程序在远程运行，此函数会自动建立一个从本地机器到远程target的端口转发隧道，并返回隧道的本地URI。端口转发隧道的生命周期由编辑器管理，用户也可以关闭隧道。

注意，通过 openExternal 传递的 uris 会自动解析，您不应该对它们调用 asExternalUri。

vscode.env.uriScheme

创建一个URI - 如果在浏览器中打开（例如通过openExternal） - 将触发已注册的UriHandler。

扩展程序不应对生成的uri做出任何假设，也不应以任何方式更改它。 相反，扩展程序可以例如在认证流程中使用此uri，通过将uri作为回调查询参数添加到服务器以进行认证。

注意，如果服务器决定向uri添加额外的查询参数（例如令牌或密钥），它将会出现在传递给UriHandler的uri中。

示例 认证流程：

vscode.window.registerUriHandler({
  handleUri(uri: vscode.Uri): vscode.ProviderResult<void> {
    if (uri.path === '/did-authenticate') {
      console.log(uri.toString());
    }
  }
});

const callableUri = await vscode.env.asExternalUri(
  vscode.Uri.parse(vscode.env.uriScheme + '://my.extension/did-authenticate')
);
await vscode.env.openExternal(callableUri);

注意，扩展程序不应缓存asExternalUri的结果，因为解析的URI可能会由于系统或用户操作而失效——例如，在远程情况下，用户可能会关闭由asExternalUri打开的端口转发隧道。

任何其他方案

任何其他方案将被视为提供的URI是工作区URI。在这种情况下，该方法将返回一个URI，当处理时，将使编辑器打开工作区。

创建一个新的遥测记录器。

使用默认应用程序外部打开链接。根据使用的方案，这可以是：

• 一个浏览器 (http:, https:)
• 邮件客户端 (mailto:)
• VSCode 本身 (vscode: 来自 vscode.env.uriScheme)

注意，showTextDocument 是在编辑器中打开文本文档的正确方式，而不是这个函数。

系统当前已知的所有扩展。

当extensions.all发生变化时触发的事件。这可能在扩展被安装、卸载、启用或禁用时发生。

通过其完整标识符获取扩展，格式为：publisher.name。

已加载的扩展程序的本地化字符串包。如果未加载任何包，则未定义。通常，如果未找到包或我们使用默认语言运行时，不会加载包。

已为扩展加载的本地化包的URI。如果未加载任何包，则为未定义。通常，如果未找到包或我们使用默认语言运行时，不会加载该包。

标记一个字符串以便进行本地化。如果为env.language指定的语言有可用的本地化包，并且该包中有此消息的本地化值，则将返回该本地化值（对于任何模板值，将注入args值）。

示例

l10n.t('Hello {0}!', 'World');

标记一个字符串以便进行本地化。如果为env.language指定的语言有可用的本地化包，并且该包中有此消息的本地化值，则将返回该本地化值（对于任何模板值，将注入args值）。

示例

l10n.t('Hello {name}', { name: 'Erich' });

标记一个字符串以便进行本地化。如果为env.language指定的语言提供了本地化包，并且该包中有此消息的本地化值，则将返回该本地化值（对于任何模板值，将注入参数值）。

当全局诊断集发生变化时触发的事件。这是新增和移除的诊断。

创建一个诊断集合。

创建一个新的语言状态项。

获取给定资源的所有诊断信息。

获取所有诊断信息。

返回所有已知语言的标识符。

计算文档选择器与文档之间的匹配度。大于零的值表示选择器与文档匹配。

匹配是根据以下规则计算的：

1. 当DocumentSelector是一个数组时，计算每个包含的DocumentFilter或语言标识符的匹配值，并取最大值。
2. 一个字符串将被解析为DocumentFilter的language部分，因此"fooLang"类似于{ language: "fooLang" }。
3. 一个DocumentFilter将通过将其部分与文档进行比较来匹配文档。以下规则适用：
   1. 当DocumentFilter为空（{}）时，结果为0
   2. 当定义了scheme、language、pattern或notebook但其中一个不匹配时，结果为0
   3. 与*匹配得分为5，通过相等或通过通配符模式匹配得分为10
   4. 结果是每个匹配的最大值

示例：

// default document from disk (file-scheme)
doc.uri; //'file:///my/file.js'
doc.languageId; // 'javascript'
match('javascript', doc); // 10;
match({ language: 'javascript' }, doc); // 10;
match({ language: 'javascript', scheme: 'file' }, doc); // 10;
match('*', doc); // 5
match('fooLang', doc); // 0
match(['fooLang', '*'], doc); // 5

// virtual document, e.g. from git-index
doc.uri; // 'git:/my/file.js'
doc.languageId; // 'javascript'
match('javascript', doc); // 10;
match({ language: 'javascript', scheme: 'git' }, doc); // 10;
match('*', doc); // 5

// notebook cell document
doc.uri; // `vscode-notebook-cell:///my/notebook.ipynb#gl65s2pmha`;
doc.languageId; // 'python'
match({ notebookType: 'jupyter-notebook' }, doc); // 10
match({ notebookType: 'fooNotebook', language: 'python' }, doc); // 0
match({ language: 'python' }, doc); // 10
match({ notebookType: '*' }, doc); // 5

注册一个调用层次结构提供者。

注册一个代码操作提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个代码镜头提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个颜色提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个完成提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并且相同分数的组会依次请求完成项。当一个或多个组的提供者返回结果时，过程停止。失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

一个完成项提供者可以与一组triggerCharacters相关联。当输入触发字符时，会请求完成项，但仅从注册了该输入字符的提供者那里获取。因此，触发字符应该与单词字符不同，常见的触发字符是.，用于触发成员完成项。

注册一个声明提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个定义提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个新的DocumentDropEditProvider。

为文档注册一个格式化提供程序。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并使用最佳匹配的提供者。所选提供者的失败将导致整个操作的失败。

注册一个文档高亮提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并依次请求文档高亮。当提供者返回non-falsy或non-failure结果时，过程停止。

注册一个文档链接提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

为文档范围注册一个格式化提供程序。

注意： 文档范围提供者也是一个文档格式化器，这意味着在注册范围提供者时，不需要再注册文档格式化器。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并使用最佳匹配的提供者。所选提供者的失败将导致整个操作的失败。

为文档范围注册一个语义标记提供者。

注意： 如果一个文档同时具有 DocumentSemanticTokensProvider 和 DocumentRangeSemanticTokensProvider， 范围提供程序将仅在最初被调用，即在全文档提供程序解析第一个请求的时间内。一旦全文档提供程序解析了第一个请求，通过范围提供程序提供的语义标记将被丢弃，从那时起，将仅使用文档提供程序。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并使用最佳匹配的提供者。所选提供者的失败将导致整个操作的失败。

为整个文档注册一个语义标记提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并使用最佳匹配的提供者。所选提供者的失败将导致整个操作的失败。

注册一个文档符号提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个提供者，用于在文本文档中定位可评估的表达式。 编辑器将在活动的调试会话中评估该表达式，并在调试悬停中显示结果。

如果为一种语言注册了多个提供者，将使用任意一个提供者。

注册一个折叠范围提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行询问，并且结果会被合并。 如果多个折叠范围从同一位置开始，则只使用第一个注册提供者的范围。 如果一个折叠范围与另一个位置较小的范围重叠，则它也会被忽略。

失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个悬停提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个实现提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个内嵌提示提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个内联完成提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个提供程序，该程序返回调试器的“内联值”功能所需的数据。 每当通用调试器在源文件中停止时，就会调用为该文件语言注册的提供程序， 以返回将在编辑器行尾显示的文本数据。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个链接编辑范围提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并使用具有结果的最佳匹配提供者。所选提供者的失败将导致整个操作的失败。

注册一个适用于类型的格式化提供程序。当用户启用设置editor.formatOnType时，该提供程序将处于活动状态。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并使用最佳匹配的提供者。所选提供者的失败将导致整个操作的失败。

注册一个参考提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个重命名提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并按顺序询问。第一个产生结果的提供者将定义整个操作的结果。

注册一个选择范围提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个签名帮助提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会根据它们的分数进行排序，并按顺序调用，直到某个提供者返回有效结果。

另请参阅 languages.registerSignatureHelpProvider

注册一个类型定义提供者。

可以为一种语言注册多个提供者。在这种情况下，提供者会被并行请求，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

注册一个类型层次结构提供者。

注册一个工作区符号提供者。

可以注册多个提供者。在这种情况下，提供者会被并行询问，并且结果会被合并。一个失败的提供者（被拒绝的承诺或异常）不会导致整个操作失败。

为一种语言设置语言配置。

设置（并更改）与给定文档关联的语言。

注意，调用此函数将触发 onDidCloseTextDocument 事件，随后触发 onDidOpenTextDocument 事件。

所有扩展注册的可用工具列表，使用lm.registerTool注册。它们可以通过lm.invokeTool调用，输入需符合其声明的inputSchema。

当可用聊天模型集合发生变化时触发的事件。

通过名称调用lm.tools中列出的工具，并使用给定的输入。输入将根据工具声明的模式进行验证。

工具可以由聊天参与者在处理聊天请求的上下文中调用，也可以由任何扩展在任何自定义流程中全局调用。

在前一种情况下，调用者应传递 toolInvocationToken，该令牌随 聊天请求一起提供。这确保了聊天界面显示正确的对话工具调用。

一个工具结果是一个由文本-和 提示-tsx-部分组成的数组。如果工具调用者使用vscode/prompt-tsx，它可以 使用ToolResult将响应部分合并到其提示中。如果不使用，这些部分可以通过带有LanguageModelToolResultPart的用户消息传递给 LanguageModelChat。

如果聊天参与者希望保留跨多个回合请求的工具结果，它可以将工具结果存储在从处理程序返回的ChatResult.metadata中，并在下一个回合从ChatResponseTurn.result中检索它们。

注册一个LanguageModelTool。该工具还必须在package.json的languageModelTools贡献点中注册。注册的工具可以在lm.tools列表中供任何扩展查看。但为了让语言模型能够看到它，必须在LanguageModelChatRequestOptions.tools的可用工具列表中传递它。

通过选择器选择聊天模型。这可能会产生多个或没有聊天模型，扩展必须优雅地处理这些情况，特别是在没有聊天模型存在时。

const models = await vscode.lm.selectChatModels({ family: 'gpt-3.5-turbo' });
if (models.length > 0) {
    const [first] = models;
    const response = await first.sendRequest(...)
    // ...
} else {
    // NO chat models available
}

选择器可以广泛匹配给定供应商或系列的所有模型，也可以通过ID精确选择一个模型。 请记住，可用的模型集将随时间变化，而且不同模型中的提示表现可能不同。

注意，扩展可以保留此函数返回的结果并在以后使用它们。然而，当触发 onDidChangeChatModels事件时，聊天模型列表可能已更改，扩展应重新查询。

创建一个新的笔记本控制器。

创建一个新的消息传递实例，用于与特定的渲染器进行通信。

• 注意 1: 扩展只能创建它们在 package.json 文件中定义的渲染器
• 注意2: 渲染器只有在notebookRenderer贡献中requiresMessaging设置为always或optional时才能访问消息传递。

为给定的笔记本类型注册一个单元格状态栏项提供者。

扩展创建的最后一个源代码控制的输入框。

• 已弃用 - 请改用 SourceControl.inputBox

创建一个新的源代码控制实例。

当前活动的任务执行或一个空数组。

当任务结束时触发。

当底层进程结束时触发。 对于不执行底层进程的任务，此事件不会触发。

当任务开始时触发。

当底层进程启动时触发。 对于不执行底层进程的任务，此事件不会触发。

执行由编辑器管理的任务。返回的任务执行可用于终止任务。

• 抛出 - 在无法启动新进程的环境中运行ShellExecution或ProcessExecution任务时。在此类环境中，只能运行CustomExecution任务。

获取系统中所有可用的任务。这包括来自tasks.json文件的任务，以及通过扩展贡献的任务提供者的任务。

注册一个任务提供者。

创建一个新的测试控制器。

当前在设置中配置的活动颜色主题。可以通过workbench.colorTheme设置更改活动主题。

当前活动的notebook editor或undefined。活动编辑器是当前具有焦点的编辑器，或者在没有焦点时，最近更改输入的编辑器。

当前活动的终端或undefined。活动终端是当前具有焦点或最近具有焦点的终端。

当前活动的编辑器或undefined。活动编辑器是当前获得焦点的编辑器，或者在没有焦点时，最近更改输入的编辑器。

表示当前窗口的状态。

表示主编辑器区域内的网格小部件

当前打开的终端或一个空数组。

当前可见的notebook editors或一个空数组。

当前可见的编辑器或一个空数组。

当活动颜色主题更改或发生变化时触发的事件。

当活动笔记本编辑器发生变化时触发的事件。注意，当活动编辑器变为undefined时，该事件也会触发。

当活动终端发生变化时触发的事件。注意，当活动终端变为undefined时，该事件也会触发。

当活动编辑器发生变化时触发的事件。注意，当活动编辑器变为undefined时，该事件也会触发。

当笔记本编辑器选择发生变化时触发的事件。

当笔记本编辑器可见范围发生变化时触发的事件。

当终端中的 shell 集成激活或其属性之一发生变化时触发。

当终端的状态发生变化时触发的事件。

当编辑器的选项发生变化时触发的事件。

当编辑器中的选择发生变化时触发的事件。

当编辑器的视图列发生变化时触发的事件。

当编辑器的可见范围发生变化时触发的事件。

当可见的笔记本编辑器发生变化时触发的事件。

当可见编辑器的数组发生变化时触发的事件。

当当前窗口的焦点或活动状态发生变化时触发的事件。事件的值表示窗口是否处于焦点状态。

当终端被处理时触发的事件。

当终端命令结束时，将触发此事件。此事件仅在终端的shell集成被激活时触发。

当终端被创建时触发的事件，无论是通过createTerminal API还是命令。

当终端命令启动时，此事件将被触发。此事件仅在终端的shell集成被激活时触发。

创建一个InputBox，让用户输入一些文本。

请注意，在许多情况下，更方便的window.showInputBox更容易使用。当window.showInputBox不提供所需的灵活性时，应使用window.createInputBox。

创建一个具有给定名称和语言ID的新输出通道 如果未提供语言ID，则默认使用Log作为语言ID。

你可以从可见编辑器或活动编辑器中访问可见或活动的输出通道作为文本文档，并使用语言ID来贡献语言功能，如语法着色、代码镜头等。

创建一个具有给定名称的新日志输出通道。

创建一个QuickPick，让用户从类型为T的项目列表中选择一个项目。

请注意，在许多情况下，使用更方便的window.showQuickPick更为简单。当window.showQuickPick无法提供所需的灵活性时，应使用window.createQuickPick。

创建一个状态栏项目。

创建一个状态栏项目。

另请参阅 createStatusBarItem 用于创建带有标识符的状态栏项。

创建一个带有后台shell进程的终端。如果存在工作区目录，终端的当前工作目录将是该目录。

• 抛出 - 在无法启动新进程的环境中运行时。

创建一个带有后台shell进程的终端。

• 抛出 - 在无法启动新进程的环境中运行时。

创建一个终端，其中扩展控制其输入和输出。

创建一个TextEditorDecorationType，可用于向文本编辑器添加装饰。

为使用扩展点views贡献的视图创建一个TreeView。

创建并显示一个新的webview面板。

为customEditors扩展点贡献的viewType注册一个自定义编辑器的提供者。

当自定义编辑器打开时，会触发一个onCustomEditor:viewType激活事件。您的扩展必须为viewType注册一个CustomTextEditorProvider、CustomReadonlyEditorProvider、CustomEditorProvider作为激活的一部分。

注册一个文件装饰提供者。

注册提供程序，使终端能够检测和处理链接。

注册一个提供者以贡献终端配置文件。

为使用扩展点views贡献的视图注册一个TreeDataProvider。 这将允许您向TreeView贡献数据，并在数据更改时进行更新。

注意：要访问TreeView并对其进行操作，请使用createTreeView。

注册一个能够处理系统范围内uris的uri处理程序。 如果有多个窗口打开，最顶层的窗口将处理该uri。 一个uri处理程序的作用范围仅限于其贡献的扩展；它只能处理指向扩展本身的uris。一个uri必须遵守以下规则：

• uri-scheme 必须是 vscode.env.uriScheme;
• uri-authority 必须是扩展 ID（例如 my.extension）；
• uri-path、-query 和 -fragment 部分是任意的。

例如，如果my.extension扩展注册了一个uri处理程序，它将只被允许处理前缀为product-name://my.extension的uris。

扩展在其整个激活生命周期内只能注册一个URI处理程序。

• 注意：有一个激活事件 onUri，当指向当前扩展的URI即将被处理时会触发。

注册一个webview面板序列化器。

支持恢复的扩展应该有一个"onWebviewPanel:viewType"激活事件，并确保在激活期间调用registerWebviewPanelSerializer。

对于给定的viewType，一次只能注册一个序列化器。

为webview视图注册一个新的提供者。

设置状态栏的消息。这是更强大的状态栏项目的简写。

设置状态栏的消息。这是更强大的状态栏项目的简写。

设置状态栏的消息。这是更强大的状态栏项目的简写。

注意状态栏消息会堆叠，当不再使用时必须处理掉。

显示错误信息。

另请参阅 showInformationMessage

显示错误信息。

另请参阅 showInformationMessage

显示错误信息。

另请参阅 showInformationMessage

显示错误信息。

另请参阅 showInformationMessage

向用户显示一条信息消息。可以选择提供一个项目数组，这些项目将显示为可点击的按钮。

向用户显示一条信息消息。可以选择提供一个项目数组，这些项目将显示为可点击的按钮。

显示一条信息消息。

另请参阅 showInformationMessage

显示一条信息消息。

另请参阅 showInformationMessage

打开一个输入框以向用户请求输入。

如果输入框被取消（例如按下ESC键），返回值将是undefined。否则，返回值将是用户输入的字符串，如果用户没有输入任何内容但通过OK按钮关闭了输入框，则返回空字符串。

在笔记本编辑器中显示给定的NotebookDocument。

向用户显示一个文件打开对话框，允许选择文件以用于打开目的。

显示一个允许多选的选项列表。

显示一个选择列表。

显示一个允许多选的选项列表。

显示一个选择列表。

向用户显示一个文件保存对话框，允许选择文件以进行保存。

在文本编辑器中显示给定的文档。可以提供列来控制编辑器的显示位置。可能会更改活动编辑器。

在文本编辑器中显示给定的文档。可以提供选项来控制显示的编辑器选项。可能会更改活动编辑器。