直接修改settings.json文件即可为Windows Terminal配置自定义快捷键,无需第三方工具或重启系统;配置位于actions数组中,含keys(如"ctrl+t")和command(字符串或对象),保存后立即生效。
直接修改 settings.json 文件就能为 windows terminal 配置自定义快捷键,整个过程不依赖第三方工具,也不需要重启系统——改完保存,快捷键立即生效。
找到并打开配置文件
Windows Terminal 的核心配置文件是 settings.json,路径固定:
- 正式版:
%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json - Preview 版:
%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminalPreview_8wekyb3d8bbwe\LocalState\settings.json
在文件资源管理器地址栏粘贴上述路径,回车即可直达。建议先备份原文件,避免误操作导致异常。
在 actions 数组中添加快捷键
快捷键定义统一放在 "actions" 数组里(不是 "keybindings",后者已弃用)。每个条目包含 "keys" 和 "command" 两部分:
-
"keys":按键组合,格式如"ctrl+shift+t"(大小写不敏感,加号连接) -
"command":可执行命令,支持字符串(如"newTab")或对象(带参数)
例如,把新建标签页改成 Ctrl+T(覆盖默认行为):
{
"command": "newTab",
"keys": "ctrl+t"
}再比如,一键打开 WSL Ubuntu 并水平分屏:
{
"command": {
"action": "wt",
"commandline": "new-tab -p \"Ubuntu\" ; split-pane -H -p \"PowerShell\""
},
"keys": "ctrl+alt+u"
}常用命令与参数参考
多数基础操作有简写形式,复杂动作需用 wt 命令行语法:
-
"copy"、"paste"、"closeTab"、"find"等直接写字符串 - 切换到指定配置文件:用
{"action":"newTab","profile":"Ubuntu"} - 调整字号:用
{"action":"adjustFontSize","delta":1}(+1 或 -1) - 打开命令面板:
"commandPalette"
所有可用命令详见官方文档 doc/specs/#2046 - Command Palette.md,参数名必须拼写准确,否则无效。
避免冲突与调试技巧
Windows Terminal 不会自动报错,但快捷键失效通常是因为:
- 同一组合键绑定了多个命令(只保留最后一个)
- 按键组合被系统或其它软件占用(如
Ctrl+Shift+Esc是任务管理器) - JSON 格式错误(缺逗号、引号不匹配),会导致整个配置加载失败
推荐做法:每次只加 1–2 条,保存后立即测试;出问题时用备份文件替换,再逐条排查。也可通过 Ctrl+Shift+P 打开命令面板,输入命令名验证是否注册成功。

















