深入解析 WezTerm 快捷键配置：键绑定和鼠标绑定
深入解析 WezTerm 的快捷键配置：键绑定和鼠标绑定WezTerm 是一个高性能的跨平台终端模拟器，它提供了广泛的自定义选项，包括键绑定和鼠标绑定，使得用户可以根据自己的需求优化操作界面。本文将详细介绍几个关键的自定义功能，解释它们的用途，并展示如何配置这些功能来提升终端使用体验。
创建一个键绑定
WezTerm 的键绑定功能允许用户为特定的操作定义快捷键。需要注意的是如果想要绑定大写或者特殊字符，需要设置key的同时设置mods，例如：
{ key = 'H', mods = 'SHIFT|LEADER', action = act.AdjustPaneSize { 'Left', 10 } },这样配置的快捷键可以通过按下 Leader 后，再按下 Shift + h (H) 来调整面板大小。
详见：https://wezfurlong.org/wezterm/config/keys.html
配置 LEADER 键
首先，定义一个 LEADER 键，作为其他快捷键的前缀。在 WezTerm 中，LEADER 键的设置如下：
local leader = { key = 'Space', mods = 'SUPER|ALT', timeout_milliseconds = math.maxinteger}这个设置允许用户通过同时按下 Win + Alt + Space 来激活领导键模式，实现类似 tmux 的操作方式。
基本的操作：
{ key = "c", mods = "LEADER", action = act { SpawnTab = "CurrentPaneDomain" } },{ key = "&", mods = "LEADER", action = act { CloseCurrentTab = { confirm = false } } },{ key = "q", mods = "LEADER", action = act { CloseCurrentTab = { confirm = false } } },{ key = "x", mods = "LEADER", action = act { CloseCurrentPane = { confirm = false } } },{ key = 's', mods = 'LEADER', action = act.PaneSelect },{ key = 'S', mods = 'SHIFT|LEADER', action = act.PaneSelect { mode = 'SwapWithActive' } },{ key = 'w', mods = 'LEADER', action = act.ShowTabNavigator },{ key = "k", mods = "LEADER", action = act.RotatePanes "Clockwise" },{ key = "T", mods = "SHIFT|CTRL", action = act { SpawnTab = "CurrentPaneDomain" } },{ key = "W", mods = "SHIFT|CTRL", action = act { CloseCurrentTab = { confirm = true } } },{ key = "V", mods = "SHIFT|CTRL", action = act { PasteFrom = "Clipboard" } },{ key = "C", mods = "SHIFT|CTRL", action = act { CopyTo = "Clipboard" } },{ key = "Tab", mods = "CTRL", action = act.ActivateTabRelative(1) },{ key = "Tab", mods = "SHIFT|CTRL", action = act.ActivateTabRelative(-1) },{ key = "Return", mods = "ALT", action = "ToggleFullScreen" },{ key = "F11", mods = "", action = "ToggleFullScreen" },键绑定表格
<hr>操作快捷键LEADER （大写字母代表 Shift + 字母）基本操作新建标签CTRL + SHIFT + t 或 ALT + tc新建面板CTRL + SHIFT(ALT) + Enter 或 ALT + nEnter关闭标签CTRL + SHIFT + w 或 ALT + q& 或 q关闭面板ALT + xx全屏ALT + Enter全屏F11复制CTRL + SHIFT + c粘贴CTRL + SHIFT + v智能复制CTRL + c面板操作智能分割CTRL + (SHIFT)ALT + EnterEnter水平分割CTRL + ALT + --垂直分割CTRL + ALT + \\面板选择CTRL + ALT + hjkl\Arrowhjkl 或 ArrowKey面板选择ALT + []面板选择ALT +hjkl面板选择ALT + ss交换面板S旋转面板k面板调整ALT + ArrowHJKL 或 SHIFT + ArrowKey 或 r 进入 resize_pane 模式（timeout 5s）面板调整CTRL + SHIFT + ALT + HJKL\Arrow标签操作标签切换CTRL + TAB 或 CTRL + SHIFT + TAB标签切换(CTRL) + ALT + 1-01-0标签切换CTRL + SHIFT + LEFT RIGHT标签切换CTRL + Alt + []n p标签移动CTRL + SHIFT + UP DOWN标签移动SHIFT + ALT + []N P 或 R 进入 move_tab 模式（timeout 5s）字体放大字体CTRL + SHIFT + =缩小字体CTRL + SHIFT + -重置字体CTRL + SHIFT + 0面板操作：激活与调整
ALT 风格的配置：
一些程序比如 tmux zellij 等会使用这些快捷键，所以这里自定义 create_keybind 函数来实现识别当前面板是否在这些程序中，如果是则不执行对应的操作，而是直接传递给程序。create_keybind 函数的实现见完整配置文件。
create_keybind("SpawnTab", "ALT", "t", "CurrentPaneDomain"),create_keybind("smart_split", "ALT", "n"),create_keybind("CloseCurrentTab", "ALT", "q"),create_keybind("CloseCurrentPane", "ALT", "x"),create_keybind("ActivatePaneDirection", "ALT", "h", "Left"),create_keybind("ActivatePaneDirection", "ALT", "j", "Down"),create_keybind("ActivatePaneDirection", "ALT", "k", "Up"),create_keybind("ActivatePaneDirection", "ALT", "l", "Right")create_keybind("ActivatePaneDirection", "ALT", "[", "Prev"),create_keybind("ActivatePaneDirection", "ALT", "]", "Next"),create_keybind("AdjustPaneSize", "ALT", "LeftArrow", "Left"),create_keybind("AdjustPaneSize", "ALT", "RightArrow", "Right"),create_keybind("AdjustPaneSize", "ALT", "UpArrow", "Up"),create_keybind("AdjustPaneSize", "ALT", "DownArrow", "Down")WezTerm Leader 键的缺点在于每个 action 都需要按下 Leader 键，这样会导致操作繁琐。例如，我们如果直接使用
{ key = 'h', mods = 'LEADER', action = act.ActivatePaneDirection 'Left' },{ key = 'j', mods = 'LEADER', action = act.ActivatePaneDirection 'Down' },{ key = 'k', mods = 'LEADER', action = act.ActivatePaneDirection 'Up' },{ key = 'l', mods = 'LEADER', action = act.ActivatePaneDirection 'Right' }这样配置的问题在于，用户每切换一次都需要按下一次 Leader 键。为了解决这个问题，我们可以创建一个函数 activate_pane_with_dir 来激活指定方向的面板，并通过 resize_pane_with_dir 来调整面板大小。这两个函数会调用对应action后，再调用 ActivateKeyTable 来激活对应的快捷键表。这样就可以像 tmux 一样，按下一次 Leader 键，然后连续按下 hjkl 来切换面板。
key_table 部分配置如下：
local key_tables = { resize_pane = { { key = 'LeftArrow',action = act.AdjustPaneSize { 'Left', 1 } }, { key = 'h', action = act.AdjustPaneSize { 'Left', 1 } }, { key = 'LeftArrow',action = act.AdjustPaneSize { 'Left', 10 },mods = 'SHIFT' }, { key = 'H', action = act.AdjustPaneSize { 'Left', 10 },mods = 'SHIFT' }, { key = 'RightArrow', action = act.AdjustPaneSize { 'Right', 1 } }, { key = 'l', action = act.AdjustPaneSize { 'Right', 1 } }, { key = 'RightArrow', action = act.AdjustPaneSize { 'Right', 10 }, mods = 'SHIFT' }, { key = 'L', action = act.AdjustPaneSize { 'Right', 10 }, mods = 'SHIFT' }, { key = 'UpArrow', action = act.AdjustPaneSize { 'Up', 1 } }, { key = 'k', action = act.AdjustPaneSize { 'Up', 1 } }, { key = 'UpArrow', action = act.AdjustPaneSize { 'Up', 10 }, mods = 'SHIFT' }, { key = 'K', action = act.AdjustPaneSize { 'Up', 10 }, mods = 'SHIFT' }, { key = 'DownArrow',action = act.AdjustPaneSize { 'Down', 1 } }, { key = 'j', action = act.AdjustPaneSize { 'Down', 1 } }, { key = 'DownArrow',action = act.AdjustPaneSize { 'Down', 10 },mods = 'SHIFT' }, { key = 'J', action = act.AdjustPaneSize { 'Down', 10 },mods = 'SHIFT' }, { key = 'Escape', action = 'PopKeyTable' }, { key = 'q', action = 'PopKeyTable' }, { key = 'Q', action = 'PopKeyTable' } },...... activate_tab = { { key = 'N', action = act.ActivateTab(0) }, { key = 'P', action = act.ActivateTab(-1) }, { key = 'n', action = act.ActivateTabRelative(1) }, { key = 'p', action = act.ActivateTabRelative(-1) }, { key = 'h', action = act.ActivateTabRelative(-1) }, { key = 'j', action = act.ActivateTabRelative(1) }, { key = 'k', action = act.ActivateTabRelative(-1) }, { key = 'l', action = act.ActivateTabRelative(1) }, { key = 'LeftArrow',action = act.ActivateTabRelative(-1) }, { key = 'RightArrow', action = act.ActivateTabRelative(1) }, { key = 'UpArrow', action = act.ActivateTabRelative(-1) }, { key = 'DownArrow',action = act.ActivateTabRelative(1) }, { key = 'Escape', action = 'PopKeyTable' },}local function activate_pane_with_dir(dir) return function(win, pane) win:perform_action(wezterm.action.ActivatePaneDirection(dir), pane) win:perform_action(wezterm.action.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 600 }, pane) endendlocal function resize_pane_with_dir(dir) return function(win, pane) win:perform_action(wezterm.action.AdjustPaneSize { dir, 10 }, pane) win:perform_action(wezterm.action.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 600 }, pane) endendlocal function activate_tab_with_dir(dir) return function(win, pane) win:perform_action(act.ActivateTabRelative(dir), pane) win:perform_action(act.ActivateKeyTable { name = 'activate_tab', one_shot = false, timeout_milliseconds = 600 }, pane) endendlocal function move_tab_with_dir(dir) return function(win, pane) win:perform_action(act.MoveTabRelative(dir), pane) win:perform_action(act.ActivateKeyTable { name = 'move_tab', one_shot = false, timeout_milliseconds = 600 }, pane) endend配置如下：
{ key = "a", mods = "LEADER", action = act.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 5000 } },{ key = 'h', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Left")) },{ key = 'j', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Down")) },{ key = 'k', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Up")) },{ key = 'l', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Right")) },{ key = "UpArrow", mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Up")) },{ key = "DownArrow",mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Down")) },{ key = "LeftArrow",mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Left")) },{ key = "RightArrow", mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Right")) },{ key = "h", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } },{ key = "j", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } },{ key = "k", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } },{ key = "l", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } },{ key = "UpArrow", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } },{ key = "DownArrow",mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } },{ key = "LeftArrow",mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } },{ key = "RightArrow", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } },{ key = 'r', mods = 'LEADER', action = act.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 5000 } },-- use Multiple keybinds fails because of async, so use action_callback{ key = 'H', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Left")) },{ key = 'J', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Down")) },{ key = 'K', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Up")) },{ key = 'L', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Right")) },{ key = "UpArrow", mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Up")) },{ key = "DownArrow",mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Down")) },{ key = "LeftArrow",mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Left")) },{ key = "RightArrow", mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Right")) },{ key = "h", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 1 } } },{ key = "l", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 1 } } },{ key = "k", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 1 } } },{ key = "j", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 1 } } },{ key = "UpArrow", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 1 } } },{ key = "DownArrow",mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 1 } } },{ key = "LeftArrow",mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 1 } } },{ key = "RightArrow", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 1 } } },面板分割
面板分割功能允许用户在一个窗口（window）中同时打开多个面板（pane），从而可以并行处理多个任务。配置如下：
{ key = "-", mods = "LEADER", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },{ key = "\\", mods = "LEADER", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },{ key = "-", mods = "ALT|CTRL", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },{ key = "\\", mods = "ALT|CTRL", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },{ key = "_", mods = "SHIFT|CTRL", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } },{ key = "|", mods = "SHIFT|CTRL", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } },通过使用 LEADER,ALT+CTRL,SHIFT+CTRL + - 和 \ 来分别进行垂直和水平分割。
配置智能分割功能
根据当前面板的尺寸来决定是进行垂直分割还是水平分割。
local function smart_split_callback(window, pane) local dim = pane:get_dimensions() if dim.pixel_height > dim.pixel_width then window:perform_action(wezterm.action.SplitVertical({ domain = "CurrentPaneDomain" }), pane) else window:perform_action(wezterm.action.SplitHorizontal({ domain = "CurrentPaneDomain" }), pane) endendlocal smart_split = wezterm.action_callback(smart_split_callback)keys = { { key = "Enter", mods = "LEADER", action = smart_split }, { key = "Enter", mods = "ALT|CTRL", action = smart_split }, { key = "Enter", mods = "SHIFT|CTRL", action = smart_split }}标签导航
create_keybind("ActivateTabRelative", "ALT|CTRL", "[", -1),create_keybind("ActivateTabRelative", "ALT|CTRL", "]", 1),{ key = "A", mods = "SHIFT|LEADER", action = act.ActivateKeyTable { name = "activate_tab", one_shot = false, timeout_milliseconds = 5000 } },{ key = "LeftArrow",mods = "SHIFT|CTRL", action = act.ActivateTabRelative(-1) },{ key = "RightArrow", mods = "SHIFT|CTRL", action = act.ActivateTabRelative(1) },{ key = "n", mods = "LEADER", action = act.ActivateTabRelative(1) },{ key = "p", mods = "LEADER", action = act.ActivateTabRelative(-1) },{ key = "1", mods = "LEADER", action = act { ActivateTab = 0 } },{ key = "2", mods = "LEADER", action = act { ActivateTab = 1 } },{ key = "3", mods = "LEADER", action = act { ActivateTab = 2 } },{ key = "4", mods = "LEADER", action = act { ActivateTab = 3 } },{ key = "5", mods = "LEADER", action = act { ActivateTab = 4 } },{ key = "6", mods = "LEADER", action = act { ActivateTab = 5 } },{ key = "7", mods = "LEADER", action = act { ActivateTab = 6 } },{ key = "8", mods = "LEADER", action = act { ActivateTab = 7 } },{ key = "9", mods = "LEADER", action = act { ActivateTab = 8 } },{ key = "0", mods = "LEADER", action = act { ActivateTab = -1 } },create_keybind("ActivateTab", "ALT", "1", 0),create_keybind("ActivateTab", "ALT", "2", 1),create_keybind("ActivateTab", "ALT", "3", 2),create_keybind("ActivateTab", "ALT", "4", 3),create_keybind("ActivateTab", "ALT", "5", 4),create_keybind("ActivateTab", "ALT", "6", 5),create_keybind("ActivateTab", "ALT", "7", 6),create_keybind("ActivateTab", "ALT", "8", 7),create_keybind("ActivateTab", "ALT", "9", 8),create_keybind("ActivateTab", "ALT", "0", -1),{ key = "1", mods = "ALT|CTRL", action = act { ActivateTab = 0 } },{ key = "2", mods = "ALT|CTRL", action = act { ActivateTab = 1 } },{ key = "3", mods = "ALT|CTRL", action = act { ActivateTab = 2 } },{ key = "4", mods = "ALT|CTRL", action = act { ActivateTab = 3 } },{ key = "5", mods = "ALT|CTRL", action = act { ActivateTab = 4 } },{ key = "6", mods = "ALT|CTRL", action = act { ActivateTab = 5 } },{ key = "7", mods = "ALT|CTRL", action = act { ActivateTab = 6 } },{ key = "8", mods = "ALT|CTRL", action = act { ActivateTab = 7 } },{ key = "9", mods = "ALT|CTRL", action = act { ActivateTab = 8 } },{ key = "0", mods = "ALT|CTRL", action = act { ActivateTab = -1 } },标签移动
{ key = "R", mods = "LEADER", action = act.ActivateKeyTable { name = "move_tab", one_shot = false, timeout_milliseconds = 5000 } },create_keybind("MoveTabRelative", "SHIFT|ALT", "{", -1),create_keybind("MoveTabRelative", "SHIFT|ALT", "}", 1),{ key = "UpArrow", mods = "SHIFT|CTRL", action = act.MoveTabRelative(-1) },{ key = "DownArrow", mods = "SHIFT|CTRL", action = act.MoveTabRelative(1) },{ key = "P", mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(-1)) },{ key = "N", mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(1)) },鼠标绑定
沿用 windows 终端的习惯是：
{event = { Down = { streak = 1, button = 'Right' } },mods = "NONE",action = wezterm.action_callback(function(window, pane) local has_selection = window:get_selection_text_for_pane(pane) ~= "" if has_selection then window:perform_action(act.CopyTo("ClipboardAndPrimarySelection"), pane) window:perform_action(act.ClearSelection, pane) else window:perform_action(act({ PasteFrom = "Clipboard" }), pane) endend)},这个配置使得鼠标右键在选择了文本时复制，没有选择时粘贴。
完整配置
keymap.lua
local wezterm = require("wezterm")local act = wezterm.action-- key bindingslocal leader = { -- win + alt + space key = 'Space', mods = 'SUPER|ALT', timeout_milliseconds = math.maxinteger}local key_tables = { resize_pane = { { key = 'LeftArrow',action = act.AdjustPaneSize { 'Left', 1 } }, { key = 'h', action = act.AdjustPaneSize { 'Left', 1 } }, { key = 'LeftArrow',action = act.AdjustPaneSize { 'Left', 10 },mods = 'SHIFT' }, { key = 'H', action = act.AdjustPaneSize { 'Left', 10 },mods = 'SHIFT' }, { key = 'RightArrow', action = act.AdjustPaneSize { 'Right', 1 } }, { key = 'l', action = act.AdjustPaneSize { 'Right', 1 } }, { key = 'RightArrow', action = act.AdjustPaneSize { 'Right', 10 }, mods = 'SHIFT' }, { key = 'L', action = act.AdjustPaneSize { 'Right', 10 }, mods = 'SHIFT' }, { key = 'UpArrow', action = act.AdjustPaneSize { 'Up', 1 } }, { key = 'k', action = act.AdjustPaneSize { 'Up', 1 } }, { key = 'UpArrow', action = act.AdjustPaneSize { 'Up', 10 }, mods = 'SHIFT' }, { key = 'K', action = act.AdjustPaneSize { 'Up', 10 }, mods = 'SHIFT' }, { key = 'DownArrow',action = act.AdjustPaneSize { 'Down', 1 } }, { key = 'j', action = act.AdjustPaneSize { 'Down', 1 } }, { key = 'DownArrow',action = act.AdjustPaneSize { 'Down', 10 },mods = 'SHIFT' }, { key = 'J', action = act.AdjustPaneSize { 'Down', 10 },mods = 'SHIFT' }, { key = 'Escape', action = 'PopKeyTable' }, { key = 'q', action = 'PopKeyTable' }, { key = 'Q', action = 'PopKeyTable' } }, activate_pane = { { key = 'LeftArrow',action = act.ActivatePaneDirection 'Left' }, { key = 'h', action = act.ActivatePaneDirection 'Left' }, { key = 'RightArrow', action = act.ActivatePaneDirection 'Right' }, { key = 'l', action = act.ActivatePaneDirection 'Right' }, { key = 'UpArrow', action = act.ActivatePaneDirection 'Up' }, { key = 'k', action = act.ActivatePaneDirection 'Up' }, { key = 'DownArrow',action = act.ActivatePaneDirection 'Down' }, { key = 'j', action = act.ActivatePaneDirection 'Down' }, { key = 'Escape', action = 'PopKeyTable' }, { key = 'q', action = 'PopKeyTable' }, { key = 'Q', action = 'PopKeyTable' } }, move_tab = { { key = 'N', action = act.MoveTabRelative(1),mods = 'SHIFT' }, { key = 'P', action = act.MoveTabRelative(-1), mods = 'SHIFT' }, { key = 'n', action = act.MoveTabRelative(1) }, { key = 'p', action = act.MoveTabRelative(-1) }, { key = 'h', action = act.MoveTabRelative(-1) }, { key = 'j', action = act.MoveTabRelative(1) }, { key = 'k', action = act.MoveTabRelative(-1) }, { key = 'l', action = act.MoveTabRelative(1) }, { key = 'LeftArrow',action = act.MoveTabRelative(-1) }, { key = 'RightArrow', action = act.MoveTabRelative(1) }, { key = 'UpArrow', action = act.MoveTabRelative(-1) }, { key = 'DownArrow',action = act.MoveTabRelative(1) }, { key = 'Escape', action = 'PopKeyTable' }, { key = 'q', action = 'PopKeyTable' }, { key = 'Q', action = 'PopKeyTable' } }, activate_tab = { { key = 'N', action = act.ActivateTab(-1) }, { key = 'P', action = act.ActivateTab(0) }, { key = 'n', action = act.ActivateTabRelative(1) }, { key = 'p', action = act.ActivateTabRelative(-1) }, { key = 'h', action = act.ActivateTabRelative(-1) }, { key = 'j', action = act.ActivateTabRelative(1) }, { key = 'k', action = act.ActivateTabRelative(-1) }, { key = 'l', action = act.ActivateTabRelative(1) }, { key = 'LeftArrow',action = act.ActivateTabRelative(-1) }, { key = 'RightArrow', action = act.ActivateTabRelative(1) }, { key = 'UpArrow', action = act.ActivateTabRelative(-1) }, { key = 'DownArrow',action = act.ActivateTabRelative(1) }, { key = 'Escape', action = 'PopKeyTable' }, { key = 'q', action = 'PopKeyTable' }, { key = 'Q', action = 'PopKeyTable' } }}-- Helper functions---------------------------------------------------------------------------------- enable actions for activating and resizing panes similar to tmux.local function activate_pane_with_dir(dir) return function(win, pane) win:perform_action(act.ActivatePaneDirection(dir), pane) win:perform_action(act.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 600 }, pane) endendlocal function resize_pane_with_dir(dir) return function(win, pane) win:perform_action(act.AdjustPaneSize { dir, 10 }, pane) win:perform_action(act.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 600 }, pane) endendlocal function activate_tab_with_dir(dir) return function(win, pane) win:perform_action(act.ActivateTabRelative(dir), pane) win:perform_action(act.ActivateKeyTable { name = 'activate_tab', one_shot = false, timeout_milliseconds = 600 }, pane) endendlocal function move_tab_with_dir(dir) return function(win, pane) win:perform_action(act.MoveTabRelative(dir), pane) win:perform_action(act.ActivateKeyTable { name = 'move_tab', one_shot = false, timeout_milliseconds = 600 }, pane) endendlocal function smart_split_callback(window, pane) local dim = pane:get_dimensions() if dim.pixel_height > dim.pixel_width then window:perform_action(act.SplitVertical({ domain = "CurrentPaneDomain" }), pane) else window:perform_action(act.SplitHorizontal({ domain = "CurrentPaneDomain" }), pane) endendlocal function is_nvim_or_tmux_or_zellij(pane) local foreground_process = pane:get_foreground_process_name() or "" local user_vars = pane:get_user_vars() if user_vars.IS_TMUX == "true" or foreground_process:find("tmux") then return true end if user_vars.IS_ZELLIJ == "true" or foreground_process:find("zellij") then return true end if user_vars.IS_NVIM == "true" or foreground_process:find("n?vim") then return true end if foreground_process:find("kitten") then return true end return falseendlocal function activate_pane_and_tab(window, pane, dir) local tab = window:mux_window():active_tab() local directions = { Left = { pane_check = "Left", tab_offset = -1 }, Right = { pane_check = "Right", tab_offset = 1 } } local dir_config = directions local action = tab:get_pane_direction(dir_config.pane_check) ~= nil and wezterm.action.ActivatePaneDirection(dir_config.pane_check) or wezterm.action.ActivateTabRelative(dir_config.tab_offset) window:perform_action(action, pane)endlocal ACTION_HANDLERS = { AdjustPaneSize = function(win, pane, dir) return { AdjustPaneSize = { dir, 5 } } end, ActivatePaneDirection = function(win, pane, dir) local panes = pane:tab():panes_with_info() local is_zoomed = false for _, p in ipairs(panes) do if p.is_zoomed then is_zoomed = true break end end if is_zoomed then dir = (dir == "Up" or dir == "Right") and "Next" or "Prev" end if dir == "Left" or dir == "Right" then activate_pane_and_tab(win, pane, dir) return end win:perform_action({ ActivatePaneDirection = dir }, pane) win:perform_action({ SetPaneZoomState = is_zoomed }, pane) end, ActivateTab = function(win, pane, dir) return wezterm.action.ActivateTab(dir) end, ActivateTabRelative = function(win, pane, dir) return wezterm.action.ActivateTabRelative(dir) end, MoveTabRelative = function(win, pane, dir) return wezterm.action.MoveTabRelative(dir) end, SpawnTab = function(win, pane, dir) return wezterm.action.SpawnTab(dir) end, CloseCurrentTab = function() return wezterm.action.CloseCurrentTab { confirm = true } end, CloseCurrentPane = function() return wezterm.action.CloseCurrentPane { confirm = true } end, smart_split = smart_split_callback,}local function create_keybind(action_str, mods, key, dir) return { key = key, mods = mods, action = wezterm.action_callback(function(win, pane) if is_nvim_or_tmux_or_zellij(pane) then win:perform_action({ SendKey = { key = key, mods = mods } }, pane) return end local handler = ACTION_HANDLERS if handler then local result = handler(win, pane, dir) if result then win:perform_action(result, pane) end else win:perform_action({ SendKey = { key = key, mods = mods } }, pane) end end) }end--------------------------------------------------------------------------------local keys = { -- {key = "s",mods = "LEADER|CTRL",action = wezterm.action {SendString = "\x01"}}, -- Normal create_keybind("SpawnTab", "ALT", "t", "CurrentPaneDomain"), create_keybind("smart_split", "ALT", "n"), create_keybind("CloseCurrentTab", "ALT", "q"), create_keybind("CloseCurrentPane", "ALT", "x"), { key = "T", mods = "SHIFT|CTRL", action = act { SpawnTab = "CurrentPaneDomain" } }, { key = "W", mods = "SHIFT|CTRL", action = act { CloseCurrentTab = { confirm = true } } }, { key = "V", mods = "SHIFT|CTRL", action = act { PasteFrom = "Clipboard" } }, { key = "C", mods = "SHIFT|CTRL", action = act { CopyTo = "Clipboard" } }, { key = "Tab", mods = "CTRL", action = act.ActivateTabRelative(1) }, { key = "Tab", mods = "SHIFT|CTRL", action = act.ActivateTabRelative(-1) }, { key = "Return", mods = "ALT", action = "ToggleFullScreen" }, { key = "F11", mods = "", action = "ToggleFullScreen" }, { key = "c", mods = "LEADER", action = act { SpawnTab = "CurrentPaneDomain" } }, { key = "&", mods = "LEADER", action = act { CloseCurrentTab = { confirm = false } } }, { key = "q", mods = "LEADER", action = act { CloseCurrentTab = { confirm = false } } }, { key = "x", mods = "LEADER", action = act { CloseCurrentPane = { confirm = false } } }, { key = 's', mods = 'LEADER', action = act.PaneSelect }, { key = 'S', mods = 'SHIFT|LEADER', action = act.PaneSelect { mode = 'SwapWithActive' } }, { key = 'w', mods = 'LEADER', action = act.ShowTabNavigator }, { key = "k", mods = "LEADER", action = act.RotatePanes "Clockwise" }, -- Pane navigation create_keybind("ActivatePaneDirection", "ALT", "h", "Left"), create_keybind("ActivatePaneDirection", "ALT", "j", "Down"), create_keybind("ActivatePaneDirection", "ALT", "k", "Up"), create_keybind("ActivatePaneDirection", "ALT", "l", "Right"), create_keybind("ActivatePaneDirection", "ALT", "[", "Prev"), create_keybind("ActivatePaneDirection", "ALT", "]", "Next"), { key = "a", mods = "LEADER", action = act.ActivateKeyTable { name = 'activate_pane', one_shot = false, timeout_milliseconds = 5000 } }, { key = 'h', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Left")) }, { key = 'j', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Down")) }, { key = 'k', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Up")) }, { key = 'l', mods = 'LEADER', action = wezterm.action_callback(activate_pane_with_dir("Right")) }, { key = "UpArrow", mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Up")) }, { key = "DownArrow",mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Down")) }, { key = "LeftArrow",mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Left")) }, { key = "RightArrow", mods = "LEADER", action = wezterm.action_callback(activate_pane_with_dir("Right")) }, { key = "h", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } }, { key = "j", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } }, { key = "k", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } }, { key = "l", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } }, { key = "UpArrow", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Up" } }, { key = "DownArrow",mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Down" } }, { key = "LeftArrow",mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Left" } }, { key = "RightArrow", mods = "ALT|CTRL", action = act { ActivatePaneDirection = "Right" } }, -- Pane resize create_keybind("AdjustPaneSize", "ALT", "LeftArrow", "Left"), create_keybind("AdjustPaneSize", "ALT", "RightArrow", "Right"), create_keybind("AdjustPaneSize", "ALT", "UpArrow", "Up"), create_keybind("AdjustPaneSize", "ALT", "DownArrow", "Down"), { key = 'r', mods = 'LEADER', action = act.ActivateKeyTable { name = 'resize_pane', one_shot = false, timeout_milliseconds = 5000 } }, -- use Multiple keybinds fails because of async, so use action_callback { key = 'H', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Left")) }, { key = 'J', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Down")) }, { key = 'K', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Up")) }, { key = 'L', mods = 'SHIFT|LEADER', action = wezterm.action_callback(resize_pane_with_dir("Right")) }, { key = "UpArrow", mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Up")) }, { key = "DownArrow",mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Down")) }, { key = "LeftArrow",mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Left")) }, { key = "RightArrow", mods = "SHIFT|LEADER", action = wezterm.action_callback(resize_pane_with_dir("Right")) }, { key = "H", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 10 } } }, { key = "J", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 10 } } }, { key = "K", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 10 } } }, { key = "L", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 10 } } }, { key = "UpArrow", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Up", 10 } } }, { key = "DownArrow",mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Down", 10 } } }, { key = "LeftArrow",mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Left", 10 } } }, { key = "RightArrow", mods = "SHIFT|ALT|CTRL", action = act { AdjustPaneSize = { "Right", 10 } } }, -- Pane splitting { key = "Enter", mods = "LEADER", action = wezterm.action_callback(smart_split_callback) }, { key = "Enter", mods = "ALT|CTRL", action = wezterm.action_callback(smart_split_callback) }, { key = "Enter", mods = "SHIFT|CTRL", action = wezterm.action_callback(smart_split_callback) }, { key = "-", mods = "ALT|CTRL", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } }, { key = "\\", mods = "ALT|CTRL", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } }, { key = "-", mods = "LEADER", action = act { SplitVertical = { domain = "CurrentPaneDomain" } } }, { key = "\\", mods = "LEADER", action = act { SplitHorizontal = { domain = "CurrentPaneDomain" } } }, { key = "m", mods = "LEADER", action = "TogglePaneZoomState" }, -- Tab navigation create_keybind("ActivateTabRelative", "ALT|CTRL", "[", -1), create_keybind("ActivateTabRelative", "ALT|CTRL", "]", 1), { key = "A", mods = "SHIFT|LEADER", action = act.ActivateKeyTable { name = "activate_tab", one_shot = false, timeout_milliseconds = 5000 } }, { key = "LeftArrow",mods = "SHIFT|CTRL", action = act.ActivateTabRelative(-1) }, { key = "RightArrow", mods = "SHIFT|CTRL", action = act.ActivateTabRelative(1) }, { key = "n", mods = "LEADER", action = wezterm.action_callback(activate_tab_with_dir(1)) }, { key = "p", mods = "LEADER", action = wezterm.action_callback(activate_tab_with_dir(-1)) }, { key = "1", mods = "LEADER", action = act { ActivateTab = 0 } }, { key = "2", mods = "LEADER", action = act { ActivateTab = 1 } }, { key = "3", mods = "LEADER", action = act { ActivateTab = 2 } }, { key = "4", mods = "LEADER", action = act { ActivateTab = 3 } }, { key = "5", mods = "LEADER", action = act { ActivateTab = 4 } }, { key = "6", mods = "LEADER", action = act { ActivateTab = 5 } }, { key = "7", mods = "LEADER", action = act { ActivateTab = 6 } }, { key = "8", mods = "LEADER", action = act { ActivateTab = 7 } }, { key = "9", mods = "LEADER", action = act { ActivateTab = 8 } }, { key = "0", mods = "LEADER", action = act { ActivateTab = -1 } }, create_keybind("ActivateTab", "ALT", "1", 0), create_keybind("ActivateTab", "ALT", "2", 1), create_keybind("ActivateTab", "ALT", "3", 2), create_keybind("ActivateTab", "ALT", "4", 3), create_keybind("ActivateTab", "ALT", "5", 4), create_keybind("ActivateTab", "ALT", "6", 5), create_keybind("ActivateTab", "ALT", "7", 6), create_keybind("ActivateTab", "ALT", "8", 7), create_keybind("ActivateTab", "ALT", "9", 8), create_keybind("ActivateTab", "ALT", "0", -1), { key = "1", mods = "ALT|CTRL", action = act { ActivateTab = 0 } }, { key = "2", mods = "ALT|CTRL", action = act { ActivateTab = 1 } }, { key = "3", mods = "ALT|CTRL", action = act { ActivateTab = 2 } }, { key = "4", mods = "ALT|CTRL", action = act { ActivateTab = 3 } }, { key = "5", mods = "ALT|CTRL", action = act { ActivateTab = 4 } }, { key = "6", mods = "ALT|CTRL", action = act { ActivateTab = 5 } }, { key = "7", mods = "ALT|CTRL", action = act { ActivateTab = 6 } }, { key = "8", mods = "ALT|CTRL", action = act { ActivateTab = 7 } }, { key = "9", mods = "ALT|CTRL", action = act { ActivateTab = 8 } }, { key = "0", mods = "ALT|CTRL", action = act { ActivateTab = -1 } }, -- Tab movement { key = "R", mods = "LEADER", action = act.ActivateKeyTable { name = "move_tab", one_shot = false, timeout_milliseconds = 5000 } }, create_keybind("MoveTabRelative", "SHIFT|ALT", "{", -1), create_keybind("MoveTabRelative", "SHIFT|ALT", "}", 1), { key = "UpArrow", mods = "SHIFT|CTRL", action = act.MoveTabRelative(-1) }, { key = "DownArrow", mods = "SHIFT|CTRL", action = act.MoveTabRelative(1) }, { key = "P", mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(-1)) }, { key = "N", mods = "SHIFT|LEADER", action = wezterm.action_callback(move_tab_with_dir(1)) }, -- other { key = "+", mods = "SHIFT|CTRL", action = act.IncreaseFontSize }, { key = "_", mods = "SHIFT|CTRL", action = act.DecreaseFontSize }, { key = ")", mods = "SHIFT|CTRL", action = act.ResetFontSize }, { key = "Backspace", mods = "SHIFT|CTRL", action = act.ResetFontSize }, { key = 'S', mods = 'SHIFT|ALT', action = act.ShowLauncherArgs { flags = 'FUZZY|TABS|LAUNCH_MENU_ITEMS' }, }, { key = 'F9', mods = 'ALT', action = act.ShowTabNavigator }, { key = 'Space', mods = 'LEADER', action = act.ShowLauncher }, { key = '/', mods = 'LEADER', action = act.ActivateCopyMode }, { key = '[', mods = 'LEADER', action = act.ActivateCopyMode }, { key = "c", mods = "CTRL", action = wezterm.action_callback(function(window, pane) local has_selection = window:get_selection_text_for_pane(pane) ~= "" if has_selection then window:perform_action( wezterm.action { CopyTo = "ClipboardAndPrimarySelection" }, pane) window:perform_action("ClearSelection", pane) else window:perform_action( wezterm.action { SendKey = { key = "c", mods = "CTRL" } }, pane) end end) }}local mouse_bindings = { { -- right clink select (not wezterm copy mode),copy, and if don't select anything, paste -- https://github.com/wez/wezterm/discussions/3541#discussioncomment-5633570 event = { Down = { streak = 1, button = 'Right' } }, mods = "NONE", action = wezterm.action_callback(function(window, pane) local has_selection = window:get_selection_text_for_pane(pane) ~= "" if has_selection then window:perform_action(act.CopyTo("ClipboardAndPrimarySelection"), pane) window:perform_action(act.ClearSelection, pane) else window:perform_action(act({ PasteFrom = "Clipboard" }), pane) end end) }, -- Change the default click behavior so that it only selects -- text and doesn't open hyperlinks { event = { Up = { streak = 1, button = 'Left' } }, mods = 'NONE', -- action = act.CompleteSelection('ClipboardAndPrimarySelection'), action = act.Nop }, -- and make CTRL-Click open hyperlinks { event = { Up = { streak = 1, button = 'Left' } }, mods = 'CTRL', action = act.OpenLinkAtMouseCursor, },}return { leader = leader, key_tables = key_tables, keys = keys, mouse_bindings = mouse_bindings,}wezterm.lua
local wezterm = require("wezterm")local keymap_config = require("keymap")local config = { check_for_updates = false, front_end = "WebGpu", max_fps = 165, enable_kitty_keyboard = true,}config.leader = keymap_config.leaderconfig.key_tables = keymap_config.key_tablesconfig.keys = keymap_config.keysconfig.mouse_bindings = keymap_config.mouse_bindingsconfig.launch_menu = launch_menureturn config
页:
[1]