VS Code API

一个 Event，当身份验证提供程序的身份验证会话被添加、删除或更改时触发。

获取用户为指定提供程序登录的所有帐户。将此与 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 区分大小写。

创建一个新的 chat participant 实例。

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

• 注意 1： 在执行编辑器命令时，并非所有类型都允许作为参数传递。允许使用原始类型 `string`、`boolean`、`number`、`undefined` 和 `null`，以及 Position、Range、Uri 和 Location。
• 注意 2： 在执行由扩展贡献的命令时没有限制。

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

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

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

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

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

创建一个新的 comment controller 实例。

当前活动的 debug console。如果没有任何调试会话处于活动状态，则发送到调试控制台的输出将不会显示。

当前活动的 debug session 或 undefined。活动调试会话是调试操作浮动窗口所代表的会话，或当前显示在调试操作浮动窗口的下拉菜单中的会话。如果没有任何调试会话处于活动状态，则该值为 undefined。

当前聚焦的线程或堆栈帧，或者如果没有任何线程或堆栈处于聚焦状态，则为 undefined。只要存在活动调试会话，就可以聚焦线程，而堆栈帧只能在会话暂停且已检索到调用堆栈时聚焦。

断点的列表。

一个 Event，当 active debug session 发生更改时会触发。注意，当活动调试会话更改为 undefined 时，也会触发该事件。

当 debug.activeStackItem 发生更改时会触发的一个事件。

当断点集被添加、删除或更改时会发出的一个 Event。

当从 debug session 接收自定义 DAP 事件时会触发的一个 Event。

当启动新的 debug session 时会触发的一个 Event。

当 debug session 终止时会触发的一个 Event。

添加断点。

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

如果“源”描述符信息不足以创建 Uri，则会抛出错误。

为特定调试类型注册 debug adapter descriptor factory。扩展只能为扩展定义的调试类型注册 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。

编辑器的当前日志级别。

计算机的唯一标识符。

远程的名称。由扩展定义，流行的示例是 wsl（用于 Windows 的 Linux 子系统）或 ssh-remote（用于使用安全 shell 的远程）。

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

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

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

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

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

一个 Event，当编辑器的日志级别改变时触发。

一个 Event，当默认 shell 改变时触发。它会以新的 shell 路径触发。

一个 Event，当用户启用或禁用遥测时触发。如果用户启用了遥测，则为 true，如果用户禁用了遥测，则为 false。

将 uri 解析为外部可访问的格式。

http: 或 https: 方案

从扩展运行的位置解析一个外部 uri，例如 http: 或 https: 链接，以获得客户端机器上同一资源的 uri。

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

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

注意，通过 openExternal 传递的 uri 会自动解析，并且您不应该对它们调用 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 的形式）获取扩展。

已为扩展加载的本地化字符串捆绑包。如果未加载捆绑包，则为 undefined。通常，如果未找到捆绑包或我们正在使用默认语言运行，则不会加载捆绑包。

已为扩展加载的本地化捆绑包的 URI。如果未加载捆绑包，则为 undefined。通常，如果未找到捆绑包或我们正在使用默认语言运行，则不会加载捆绑包。

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

示例

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

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

示例

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

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

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

创建诊断集合。

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

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

获取所有诊断。

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

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

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

1. 当 DocumentSelector 是数组时，计算每个包含的 DocumentFilter 或语言标识符的匹配，并取最大值。
2. 字符串将被解糖为成为 DocumentFilter 的 language 部分，所以 "fooLang" 就像 { language: "fooLang" }。
3. 通过将 DocumentFilter 的部分与文档进行比较，将 DocumentFilter 与文档进行匹配。以下规则适用
   1. 当 DocumentFilter 为空 ({}) 时，结果为 0
   2. 当 scheme、language、pattern 或 notebook 被定义，但其中一个不匹配时，结果为 0
   3. 与 * 匹配得到分数 5，通过相等或 glob 模式匹配得到分数 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。

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

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

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

可以为一种语言注册多个提供者。在这种情况下，提供者会按它们的 分数 排序，并且会按顺序询问这些组以获取文档高亮。当提供者返回 非假值 或 非失败 结果时，该过程就会停止。

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

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

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

注意: 文档范围提供者也是一个 文档格式化程序，这意味着当也注册范围提供者时，不需要 注册 文档格式化程序。

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

为文档范围注册语义标记提供程序。

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

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

为整个文档注册语义标记提供程序。

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

注册文档符号提供程序。

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

注册一个提供程序，该提供程序在文本文档中查找可评估表达式。编辑器将在活动调试会话中评估表达式，并将结果显示在调试悬停中。

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

注册折叠范围提供程序。

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

失败的提供程序（拒绝的 promise 或异常）不会导致整个操作失败。

注册悬停提供程序。

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

注册实现提供程序。

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

注册内联提示提供程序。

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

注册内联补全提供程序。

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

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

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

注册链接编辑范围提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序按其分数排序，并且使用具有结果的最佳匹配提供程序。所选提供程序的失败将导致整个操作失败。

注册在键入时工作的格式化提供程序。当用户启用设置editor.formatOnType时，提供程序处于活动状态。

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

注册引用提供程序。

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

注册重命名提供程序。

可以为一种语言注册多个提供程序。在这种情况下，提供程序按其分数排序，并按顺序询问。第一个产生结果的提供程序定义了整个操作的结果。

注册选择范围提供程序。

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

注册签名帮助提供程序。

多个提供者可以注册到一种语言。在这种情况下，提供者按其 得分 排序，并按顺序调用，直到某个提供者返回有效结果。

另请参见 languages.registerSignatureHelpProvider

注册类型定义提供者。

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

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

注册工作区符号提供者。

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

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

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

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

所有扩展使用 lm.registerTool 注册的所有可用工具的列表。可以使用 lm.invokeTool 调用它们，输入内容必须与其声明的 inputSchema 相匹配。

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

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

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

在前一种情况下，调用者应传递 toolInvocationToken，它来自 聊天请求。这样可以确保聊天 UI 显示与正确对话相关的工具调用。

工具 结果 是 文本 和 prompt-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 设置更改。

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

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

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

表示当前窗口的状态。

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

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

当前可见的 笔记本编辑器 或空数组。

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

一个 Event，当活动颜色主题发生更改或有更改时触发。

一个 Event，当 活动笔记本编辑器 发生更改时触发。注意，当活动编辑器更改为 undefined 时，该事件也会触发。

一个 Event，当 活动终端 发生更改时触发。注意，当活动终端更改为 undefined 时，该事件也会触发。

一个 Event，当 活动编辑器 发生更改时触发。注意，当活动编辑器更改为 undefined 时，该事件也会触发。

一个 Event，当 笔记本编辑器选择 发生更改时触发。

一个 Event，当 笔记本编辑器可见范围 发生更改时触发。

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

一个 Event，当一个 终端的状态 发生改变时触发。

一个 Event，当编辑器的选项发生改变时触发。

一个 Event，当编辑器的选择发生改变时触发。

一个 Event，当编辑器的视图列发生改变时触发。

一个 Event，当编辑器的可见范围发生改变时触发。

一个 Event，当 可见的笔记本编辑器 发生改变时触发。

一个 Event，当 可见编辑器 数组发生改变时触发。

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

一个 Event，当一个终端被释放时触发。

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

一个 Event，当终端创建时触发，无论是通过 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 进程创建一个 Terminal。如果工作区目录存在，则终端的 cwd 将是工作区目录。

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

使用支持的 shell 进程创建一个 Terminal。

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

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

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

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

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

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

当打开自定义编辑器时，会触发一个 onCustomEditor:viewType 激活事件。你的扩展必须注册一个 CustomTextEditorProvider、CustomReadonlyEditorProvider、CustomEditorProvider，用于在激活过程中为 viewType 提供服务。

注册文件装饰提供程序。

注册提供程序，以启用终端中链接的检测和处理。

注册一个为贡献的终端配置文件提供服务的提供程序。

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

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

注册一个能够处理系统范围内的 uris 的 uri 处理程序。如果有多个窗口打开，最顶层的窗口将处理该 uri。uri 处理程序的范围限定为它所在的扩展程序；它只能处理指向自身扩展程序的 uri。uri 必须遵守以下规则：

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

例如，如果 my.extension 扩展程序注册了一个 uri 处理程序，则它只能处理以 product-name://my.extension 为前缀的 uri。

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

• 注意： 有一个激活事件 onUri，它会在要处理指向当前扩展程序的 uri 时触发。

注册 webview 面板序列化器。

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

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

注册一个新的 webview 视图提供程序。

在状态栏中设置一条消息。这是对更强大的状态栏 items 的简写。

在状态栏中设置一条消息。这是对更强大的状态栏 items 的简写。

在状态栏中设置一条消息。这是对更强大的状态栏 items 的简写。

注意 状态栏消息会堆叠，并且在不再使用时必须对其进行处理。

显示一条错误消息。

另请参阅 showInformationMessage

显示一条错误消息。

另请参阅 showInformationMessage

显示一条错误消息。

另请参阅 showInformationMessage

显示一条错误消息。

另请参阅 showInformationMessage

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

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

显示一条信息消息。

另请参阅 showInformationMessage

显示一条信息消息。

另请参阅 showInformationMessage

打开一个输入框以询问用户输入。

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

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

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

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

显示一个选择列表。

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

显示一个选择列表。

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

在文本编辑器中显示给定的文档。可以提供一个列来控制编辑器在哪里显示。可能会改变活动编辑器。

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