参加你附近的 ，了解 VS Code 中的 AI 辅助开发。

内置命令

本文档列出了您可能与 vscode.commands.executeCommand API 一起使用的 Visual Studio Code 命令的子集。

阅读命令指南，了解如何使用命令 API。

以下是如何在 VS Code 中打开一个新文件夹的示例：

let uri = Uri.file('/some/path/to/folder');
let success = await commands.executeCommand('vscode.openFolder', uri);

注意：您可以通过“键盘快捷方式”编辑器查看 VS Code 的所有命令：文件 > 首选项 > 键盘快捷方式。“键盘快捷方式”编辑器列出了 VS Code 内置或扩展贡献的所有命令，以及它们的键绑定和可见性条件。

命令

vscode.executeDataToNotebook - 调用笔记本序列化器

  • notebookType - 笔记本类型
  • data - 要转换为数据的字节
  • (返回) - 笔记本数据

vscode.executeNotebookToData - 调用笔记本序列化器

  • notebookType - 笔记本类型
  • NotebookData - 要转换为字节的笔记本数据
  • (返回) - 字节

notebook.selectKernel - 触发指定笔记本编辑器小部件的内核选择器

  • options - 选择内核选项
  • (返回) - 无结果

interactive.open - 打开交互式窗口并返回笔记本编辑器和输入 URI

  • showOptions - 显示选项
  • resource - 交互式资源 Uri
  • controllerId - 笔记本控制器 Id
  • title - 交互式编辑器标题
  • (返回) - 笔记本和输入 URI

vscode.editorChat.start - 调用新的编辑器聊天会话

  • 运行参数 -
  • (返回) - 无结果

vscode.executeDocumentHighlights - 执行文档高亮提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 DocumentHighlight 实例的数组。

vscode.executeDocumentSymbolProvider - 执行文档符号提供程序。

  • uri - 文本文档的 Uri
  • (返回) - 一个 Promise，解析为 SymbolInformation 和 DocumentSymbol 实例的数组。

vscode.executeFormatDocumentProvider - 执行文档格式化提供程序。

  • uri - 文本文档的 Uri
  • options - 格式化选项
  • (返回) - 一个 Promise，解析为 TextEdit 数组。

vscode.executeFormatRangeProvider - 执行范围格式化提供程序。

  • uri - 文本文档的 Uri
  • range - 文本文档中的一个范围
  • options - 格式化选项
  • (返回) - 一个 Promise，解析为 TextEdit 数组。

vscode.executeFormatOnTypeProvider - 执行按键格式化提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • ch - 触发字符
  • options - 格式化选项
  • (返回) - 一个 Promise，解析为 TextEdit 数组。

vscode.executeDefinitionProvider - 执行所有定义提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 Location 或 LocationLink 实例的数组。

vscode.executeTypeDefinitionProvider - 执行所有类型定义提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 Location 或 LocationLink 实例的数组。

vscode.executeDeclarationProvider - 执行所有声明提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 Location 或 LocationLink 实例的数组。

vscode.executeImplementationProvider - 执行所有实现提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 Location 或 LocationLink 实例的数组。

vscode.executeReferenceProvider - 执行所有引用提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 Location 实例的数组。

vscode.executeHoverProvider - 执行所有悬停提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 Hover 实例的数组。

vscode.executeSelectionRangeProvider - 执行选择范围提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为范围数组。

vscode.executeWorkspaceSymbolProvider - 执行所有工作区符号提供程序。

  • query - 搜索字符串
  • (返回) - 一个 Promise，解析为 SymbolInformation 实例的数组。

vscode.prepareCallHierarchy - 在文档中指定位置准备调用层次结构

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 CallHierarchyItem 实例的数组

vscode.provideIncomingCalls - 计算项的传入调用

  • item - 调用层次结构项
  • (返回) - 一个 Promise，解析为 CallHierarchyIncomingCall 实例的数组

vscode.provideOutgoingCalls - 计算项的传出调用

  • item - 调用层次结构项
  • (返回) - 一个 Promise，解析为 CallHierarchyOutgoingCall 实例的数组

vscode.prepareRename - 执行重命名提供程序的 prepareRename。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为范围和占位符文本。

vscode.executeDocumentRenameProvider - 执行重命名提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • newName - 新的符号名称
  • (返回) - 一个 Promise，解析为 WorkspaceEdit。

vscode.executeLinkProvider - 执行文档链接提供程序。

  • uri - 文本文档的 Uri
  • linkResolveCount - (可选) 应解析的链接数量，仅当链接未解析时。
  • (返回) - 一个 Promise，解析为 DocumentLink 实例的数组。

vscode.provideDocumentSemanticTokensLegend - 为文档提供语义标记图例

  • uri - 文本文档的 Uri
  • (返回) - 一个 Promise，解析为 SemanticTokensLegend。

vscode.provideDocumentSemanticTokens - 为文档提供语义标记

  • uri - 文本文档的 Uri
  • (返回) - 一个 Promise，解析为 SemanticTokens。

vscode.provideDocumentRangeSemanticTokensLegend - 为文档范围提供语义标记图例

  • uri - 文本文档的 Uri
  • range - (可选) 文本文档中的一个范围
  • (返回) - 一个 Promise，解析为 SemanticTokensLegend。

vscode.provideDocumentRangeSemanticTokens - 为文档范围提供语义标记

  • uri - 文本文档的 Uri
  • range - 文本文档中的一个范围
  • (返回) - 一个 Promise，解析为 SemanticTokens。

vscode.executeCompletionItemProvider - 执行补全项提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • triggerCharacter - (可选) 当用户输入字符（如 , 或 (）时触发补全
  • itemResolveCount - (可选) 要解析的补全数量（数量过大将降低补全速度）
  • (返回) - 一个 Promise，解析为 CompletionList 实例。

vscode.executeSignatureHelpProvider - 执行签名帮助提供程序。

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • triggerCharacter - (可选) 当用户输入字符（如 , 或 (）时触发签名帮助
  • (返回) - 一个 Promise，解析为 SignatureHelp。

vscode.executeCodeLensProvider - 执行代码镜头提供程序。

  • uri - 文本文档的 Uri
  • itemResolveCount - (可选) 应解析并返回的代码镜头数量。将仅返回已解析的镜头，这会影响性能。
  • (返回) - 一个 Promise，解析为 CodeLens 实例的数组。

vscode.executeCodeActionProvider - 执行代码操作提供程序。

  • uri - 文本文档的 Uri
  • rangeOrSelection - 文本文档中的范围。某些重构提供程序需要 Selection 对象。
  • kind - (可选) 要返回代码操作的代码操作类型
  • itemResolveCount - (可选) 要解析的代码操作数量（数量过大将降低代码操作速度）
  • (返回) - 一个 Promise，解析为 Command 实例的数组。

vscode.executeDocumentColorProvider - 执行文档颜色提供程序。

  • uri - 文本文档的 Uri
  • (返回) - 一个 Promise，解析为 ColorInformation 对象的数组。

vscode.executeColorPresentationProvider - 执行颜色呈现提供程序。

  • color - 要显示和插入的颜色
  • context - 包含 uri 和 range 的上下文对象
  • (返回) - 一个 Promise，解析为 ColorPresentation 对象的数组。

vscode.executeInlayHintProvider - 执行内联提示提供程序

  • uri - 文本文档的 Uri
  • range - 文本文档中的一个范围
  • (返回) - 一个 Promise，解析为 Inlay 对象数组

vscode.executeFoldingRangeProvider - 执行折叠范围提供程序

  • uri - 文本文档的 Uri
  • (返回) - 一个 Promise，解析为 FoldingRange 对象数组

vscode.resolveNotebookContentProviders - 解析笔记本内容提供程序

  • (返回) - 一个 Promise，解析为 NotebookContentProvider 静态信息对象的数组。

vscode.executeInlineValueProvider - 执行内联值提供程序

  • uri - 文本文档的 Uri
  • range - 文本文档中的一个范围
  • context - 一个 InlineValueContext
  • (返回) - 一个 Promise，解析为 InlineValue 对象数组

vscode.open - 在编辑器中打开提供的资源。可以是文本或二进制文件，也可以是 http(s) URL。如果您需要对打开文本文件的选项进行更多控制，请改用 vscode.window.showTextDocument。

  • uri - 文本或二进制文件，或 http(s) URL 的 Uri
  • columnOrOptions - (可选) 要打开的列，或编辑器选项，请参阅 vscode.TextDocumentShowOptions
  • label - 编辑器标签 (可选)
  • (返回) - 无结果

vscode.openWith - 使用特定编辑器打开提供的资源。

  • resource - 要打开的资源
  • viewId - 自定义编辑器视图 ID 或“default”以使用 VS Code 的默认编辑器
  • columnOrOptions - (可选) 要打开的列，或编辑器选项，请参阅 vscode.TextDocumentShowOptions
  • (返回) - 无结果

vscode.diff - 在差异编辑器中打开提供的资源以比较其内容。

  • left - 差异编辑器的左侧资源
  • right - 差异编辑器的右侧资源
  • title - 差异编辑器的人类可读标题
  • options - (可选) 要打开的列，或编辑器选项（请参阅 vscode.TextDocumentShowOptions）

vscode.changes - 在更改编辑器中打开资源列表以比较其内容。

  • title - 更改编辑器的人类可读标题
  • resourceList - 要比较的资源列表

vscode.prepareTypeHierarchy - 在文档中指定位置准备类型层次结构

  • uri - 文本文档的 Uri
  • position - 文本文档中的一个位置
  • (返回) - 一个 Promise，解析为 TypeHierarchyItem 实例的数组

vscode.provideSupertypes - 计算项的超类型

  • item - 类型层次结构项
  • (返回) - 一个 Promise，解析为 TypeHierarchyItem 实例的数组

vscode.provideSubtypes - 计算项的子类型

  • item - 类型层次结构项
  • (返回) - 一个 Promise，解析为 TypeHierarchyItem 实例的数组

vscode.revealTestInExplorer - 在资源管理器中显示测试实例

  • testItem - 一个 VS Code TestItem。
  • (返回) - 无结果

setContext - 设置一个可在 when 子句中使用的自定义上下文键值。

  • name - 上下文键名称
  • value - 上下文键值
  • (返回) - 无结果

vscode.executeMappedEditsProvider - 执行映射编辑提供程序

  • uri - 文本文档的 Uri
  • string_array - 字符串数组，
  • MappedEditsContext - 映射编辑上下文
  • (返回) - 一个 Promise，解析为工作区编辑或 null

cursorMove - 将光标移动到视图中的逻辑位置

  • 光标移动参数对象 - 可以通过此参数传递的属性-值对
    • 'to': 一个强制性的逻辑位置值，指示光标移动到何处。
      'left', 'right', 'up', 'down', 'prevBlankLine', 'nextBlankLine',
'wrappedLineStart', 'wrappedLineEnd', 'wrappedLineColumnCenter'
'wrappedLineFirstNonWhitespaceCharacter', 'wrappedLineLastNonWhitespaceCharacter'
'viewPortTop', 'viewPortCenter', 'viewPortBottom', 'viewPortIfOutside'
    • 'by': 移动单位。默认值根据 'to' 值计算。
      'line', 'wrappedLine', 'character', 'halfLine'
    • 'value': 移动单位数量。默认值为 '1'。
    • 'select': 如果为 'true' 则进行选择。默认值为 'false'。

editorScroll - 沿给定方向滚动编辑器

  • 编辑器滚动参数对象 - 可以通过此参数传递的属性-值对
    • 'to': 一个强制性的方向值。
      'up', 'down'
    • 'by': 移动单位。默认值根据 'to' 值计算。
      'line', 'wrappedLine', 'page', 'halfPage', 'editor'
    • 'value': 移动单位数量。默认值为 '1'。
    • 'revealCursor': 如果为 'true' 且光标在视图端口外，则显示光标。

revealLine - 在给定逻辑位置显示给定行

  • 显示行参数对象 - 可以通过此参数传递的属性-值对
    • 'lineNumber': 一个强制性的行号值。
    • 'at': 行需要显示所在的逻辑位置。
      'top', 'center', 'bottom'

editor.unfold - 展开编辑器中的内容

  • 展开编辑器参数 - 可以通过此参数传递的属性-值对
    • 'levels': 要展开的级别数。如果未设置，默认为 1。
    • 'direction': 如果为 'up'，则向上展开给定数量的级别，否则向下展开。
    • 'selectionLines': 要应用展开操作的编辑器选择的起始行（基于 0）数组。如果未设置，将使用活动选择。

editor.fold - 折叠编辑器中的内容

  • 折叠编辑器参数 - 可以通过此参数传递的属性-值对
    • 'levels': 要折叠的级别数。
    • 'direction': 如果为 'up'，则向上折叠给定数量的级别，否则向下折叠。
    • 'selectionLines': 要应用折叠操作的编辑器选择的起始行（基于 0）数组。如果未设置，将使用活动选择。如果未设置级别或方向，则折叠指定位置的区域，如果已折叠，则折叠第一个未折叠的父级。

editor.toggleFold - 根据编辑器内容的当前状态折叠或展开内容

editor.actions.findWithArgs - 打开带有特定选项的新编辑器内查找小部件。

  • searchString - 用于预填充查找输入的字符串
  • replaceString - 用于预填充替换输入的字符串
  • isRegex - 启用正则表达式
  • preserveCase - 替换时尝试保持相同的大小写
  • findInSelection - 将查找位置限制在当前选择中
  • matchWholeWord
  • isCaseSensitive

editor.action.goToLocations - 从文件中的位置转到位置

  • uri - 开始的文本文档
  • position - 开始的位置
  • locations - 位置数组。
  • multiple - 定义当有多个结果时如何操作，可以是 peek、gotoAndPeek 或 `goto`
  • noResultsMessage - 当位置为空时显示的人类可读消息。

editor.action.peekLocations - 从文件中的位置预览位置

  • uri - 开始的文本文档
  • position - 开始的位置
  • locations - 位置数组。
  • multiple - 定义当有多个结果时如何操作，可以是 peek、gotoAndPeek 或 `goto`

workbench.action.quickOpen - 快速访问

  • prefix -

notebook.cell.toggleOutputs - 切换输出

  • options - 单元格范围选项

notebook.fold - 折叠单元格

  • index - 单元格索引

notebook.unfold - 展开单元格

  • index - 单元格索引

notebook.selectKernel - 笔记本内核参数

  • kernelInfo - 内核信息

notebook.cell.changeLanguage - 更改单元格语言

  • range - 单元格范围
  • language - 目标单元格语言

notebook.execute - 全部运行

  • uri - 文档 uri

notebook.cell.execute - 执行单元格

  • options - 单元格范围选项

notebook.cell.executeAndFocusContainer - 执行单元格并聚焦容器

  • options - 单元格范围选项

notebook.cell.cancelExecution - 停止单元格执行

  • options - 单元格范围选项

workbench.action.findInFiles - 打开工作区搜索

  • 一组搜索选项 -

_interactive.open - 打开交互式窗口

  • showOptions - 显示选项
  • resource - 交互式资源 Uri
  • controllerId - 笔记本控制器 Id
  • title - 笔记本编辑器标题

interactive.execute - 执行输入框的内容

  • resource - 交互式资源 Uri

search.action.openNewEditor - 打开一个新的搜索编辑器。传递的参数可以包含诸如 ${relativeFileDirname} 等变量。

  • 打开新的搜索编辑器参数 -

search.action.openEditor - 打开一个新的搜索编辑器。传递的参数可以包含诸如 ${relativeFileDirname} 等变量。

  • 打开新的搜索编辑器参数 -

search.action.openNewEditorToSide - 打开一个新的搜索编辑器。传递的参数可以包含诸如 ${relativeFileDirname} 等变量。

  • 打开新的搜索编辑器参数 -

vscode.openFolder - 在当前窗口或新窗口中打开文件夹或工作区，具体取决于 newWindow 参数。请注意，在同一窗口中打开将关闭当前扩展主机进程并在给定文件夹/工作区上启动一个新进程，除非 newWindow 参数设置为 true。

  • uri - (可选) 要打开的文件夹或工作区文件的 Uri。如果未提供，将弹出原生对话框要求用户选择文件夹
  • options - (可选) 选项。具有以下属性的对象：forceNewWindow：是否在新窗口或同一窗口中打开文件夹/工作区。默认为在同一窗口中打开。forceReuseWindow：是否强制在同一窗口中打开文件夹/工作区。默认为 false。noRecentEntry：打开的 URI 是否会出现在“最近打开”列表中。默认为 false。注意，为了向后兼容，options 也可以是布尔类型，表示 forceNewWindow 设置。

vscode.newWindow - 根据 newWindow 参数打开一个新窗口。

  • options - (可选) 选项。具有以下属性的对象：reuseWindow：是否打开新窗口或同一窗口。默认为在新窗口中打开。

vscode.removeFromRecentlyOpened - 从最近打开的列表中删除具有给定路径的条目。

  • path - 要从最近打开的列表中删除的 URI 或 URI 字符串。

moveActiveEditor - 通过标签或组移动活动编辑器

  • 活动编辑器移动参数 - 参数属性
    • 'to': 提供要移动到的位置的字符串值。
    • 'by': 提供移动单位（按标签或按组）的字符串值。
    • 'value': 提供移动多少位置或绝对位置的数字值。

copyActiveEditor - 通过组复制活动编辑器

  • 活动编辑器复制参数 - 参数属性
    • 'to': 提供要复制到的位置的字符串值。
    • 'value': 提供复制多少位置或绝对位置的数字值。

vscode.getEditorLayout - 获取编辑器布局

  • (返回) - 一个编辑器布局对象，格式与 vscode.setEditorLayout 相同

workbench.action.files.newUntitledFile - 新建无标题文本文件

  • 新建无标题文本文件参数 - 如果已知，则是编辑器视图类型或语言 ID

workbench.extensions.installExtension - 安装给定扩展

  • extensionIdOrVSIXUri - 扩展 ID 或 VSIX 资源 URI
  • options - (可选) 安装扩展的选项。具有以下属性的对象：installOnlyNewlyAddedFromExtensionPackVSIX：启用后，VS Code 仅安装扩展包 VSIX 中新添加的扩展。此选项仅在安装 VSIX 时考虑。

workbench.extensions.uninstallExtension - 卸载给定扩展

  • 要卸载的扩展 ID -

workbench.extensions.search - 搜索特定扩展

  • 搜索中使用的查询 -

workbench.action.tasks.runTask - 运行任务

  • args - 筛选快速选择中显示的任务

workbench.action.openIssueReporter - 打开问题报告器并可选地预填充部分表单。

  • options - 用于预填充问题报告器的数据。

vscode.openIssueReporter - 打开问题报告器并可选地预填充部分表单。

  • options - 用于预填充问题报告器的数据。

workbench.action.openLogFile - workbench.action.openLogFile

  • logFile -

workbench.action.openWalkthrough - 打开演练。

  • walkthroughID - 要打开的演练 ID。
  • toSide - 在旁边的新编辑器组中打开演练。

简单命令

不需要参数的简单命令可以在默认的 keybindings.json 文件中的键盘快捷方式列表中找到。未绑定的命令列在文件底部的注释块中。

要查看默认的 keybindings.json，请从命令面板运行首选项：打开默认键盘快捷方式 (JSON)（⇧⌘P（Windows、Linux Ctrl+Shift+P））。

10/09/2025