命令面板显示可以在 Windows Terminal 中执行的操作。 有关如何定义操作的详细信息,请参阅操作页面。
调用命令面板
键入 Ctrl+Shift+P 以打开命令面板。 可以通过将 commandPalette 命令添加到密钥绑定来自定义此快捷方式。
{ "command": "commandPalette", "keys": "ctrl+shift+p" }
命令行模式
如果要在命令面板中输入 wt 命令,请删除文本框中的 > 字符。 此操作在当前窗口中运行wt命令。 有关命令的详细信息 wt ,请参阅 “命令行参数”页。
可以添加自定义键绑定,以便直接在命令行模式下调用命令面板。
{ "command": "commandPalette", "launchMode": "commandLine", "keys": "" }
向命令添加图标
可以将图标添加到命令面板中显示的 settings.json 中定义的命令。 将icon属性添加到动作中。 图标可以是图像的路径、 Segoe MDL2 Assets 中的符号或任何字符,包括表情符号。
{ "icon": "C:\\Images\\my-icon.png", "name": "New tab", "command": "newTab", "keys": "ctrl+shift+t" },
{ "icon": "\uE756", "name": "New tab", "command": "newTab", "keys": "ctrl+shift+t" },
{ "icon": "⚡", "name": "New tab", "command": "newTab", "keys": "ctrl+shift+t" }
注释
从 Windows 终端 1.24 开始, icon 可能引用文件 settings.json 旁边的内容。
嵌套命令
嵌套命令允许在命令面板中的一项下对多个命令进行分组。 以下示例将字体大小调整命令分组到名为 “更改字号...”的一个命令面板项下。
{
"name": "Change font size...",
"commands": [
{ "command": { "action": "adjustFontSize", "delta": 1 } },
{ "command": { "action": "adjustFontSize", "delta": -1 } },
{ "command": "resetFontSize" },
]
}
可迭代命令
可迭代命令允许同时创建多个命令,这些命令是从设置中定义的其他对象生成的。 目前,可以为配置文件和配色方案创建可迭代命令。 在运行时,这些命令会为给定类型的每个对象展开为一个命令。
当前可循环访问以下属性:
iterateOn |
资产 | 属性语法 |
|---|---|---|
profiles |
name |
"name": "${profile.name}" |
profiles |
icon |
"icon": "${profile.icon}" |
schemes |
name |
"name": "${scheme.name}" |
Example
为每个配置文件创建新的标签命令。
{
"iterateOn": "profiles",
"icon": "${profile.icon}",
"name": "${profile.name}",
"command": { "action": "newTab", "profile": "${profile.name}" }
}
在上面的示例中:
-
"iterateOn": "profiles"为每个用户配置生成一个命令。 - 在运行时,终端将用每个配置文件的图标替换
${profile.icon},用每个配置文件的名称替换${profile.name}。
如果你有三个用户档案:
"profiles": [
{ "name": "Command Prompt", "icon": null },
{ "name": "PowerShell", "icon": "C:\\path\\to\\icon.png" },
{ "name": "Ubuntu", "icon": null },
]
上述命令的行为类似于以下三个命令:
{
"icon": null,
"name": "Command Prompt",
"command": { "action": "newTab", "profile": "Command Prompt" }
},
{
"icon": "C:\\path\\to\\icon",
"name": "PowerShell",
"command": { "action": "newTab", "profile": "PowerShell" }
},
{
"icon": null,
"name": "Ubuntu",
"command": { "action": "newTab", "profile": "Ubuntu" }
}
还可以组合嵌套和可迭代命令。 例如,可以将上述示例中的三个“新建选项卡”命令组合在命令面板中的单个“新建选项卡”条目下,如上图中所示:
{
"name": "New tab",
"commands": [
{
"iterateOn": "profiles",
"icon": "${profile.icon}",
"name": "${profile.name}",
"command": { "action": "newTab", "profile": "${profile.name}" }
}
]
}
隐藏命令
如果要在键绑定列表中保留命令,但不希望命令显示在命令面板中,请将其 name 设置为 null。 以下示例从命令面板中隐藏“新建选项卡”操作。
{ "name": null, "command": "newTab", "keys": "ctrl+shift+t" }