VS Code 扩展命令贡献

此技能帮助您在 VS Code 扩展中贡献命令。

何时使用此技能

当您需要以下操作时，可使用此技能：

• 向您的 VS Code 扩展添加或更新命令

操作指南

VS Code 命令必须始终定义一个 title，无论其类别、可见性或位置如何。我们对每种“类型”的命令使用一些模式，并带有一些特征，如下所述：

• 常规命令：默认情况下，所有命令都应在命令面板中可访问，必须定义一个 category，并且除非该命令将用于侧边栏，否则不需要 icon。
• 侧边栏命令：其名称遵循特殊模式，以下划线 (_) 开头，并以 #sideBar 结尾，例如 _extensionId.someCommand#sideBar。必须定义一个 icon，并且可能有也可能没有某些 enablement 规则。侧边栏专用命令不应在命令面板中可见。将其贡献给 view/title 或 view/item/context 时，我们必须告知其显示的顺序/位置，我们可以使用“相对于其他命令/按钮”这样的术语来帮助您确定要使用的正确 group。此外，定义新命令可见的条件 (when) 也是一个好习惯。