WezTerm 配置记录

WezTerm 配置记录

配置文件路径

WezTerm 主配置文件：

C:\Users\Administrator\.wezterm.lua

NuShell 配置文件：

C:\Users\Administrator\AppData\Roaming\nushell\config.nu

Claude Code 快捷命令

在 NuShell 配置文件中添加/维护 cc 命令：

def cc [] {
    wezterm cli set-tab-title "Claude"
    claude --dangerously-skip-permissions
}

效果：

cc

等价于：

claude --dangerously-skip-permissions

并且会把当前 WezTerm 标签页标题设置为：

Claude

字体配置

字体配置位于：

C:\Users\Administrator\.wezterm.lua

当前使用字体 fallback：

config.font = wezterm.font_with_fallback({
  'JetBrains Mono',
  'CaskaydiaCove Nerd Font',
  'Cascadia Code',
  'Microsoft YaHei',
})
config.font_size = 12.5

字体优先级：

顺序	字体	用途
1	JetBrains Mono	主要英文字体 / 编程字体
2	CaskaydiaCove Nerd Font	Nerd Font 图标和特殊符号补全
3	Cascadia Code	备用编程字体
4	Microsoft YaHei	中文字体 fallback

当前字号：

config.font_size = 12.5

WezTerm 快捷键

快捷键配置位于：

C:\Users\Administrator\.wezterm.lua

对应配置段：

config.keys = {
  { key = 'RightArrow', mods = 'ALT|SHIFT', action = act.SplitHorizontal {} },
  { key = 'DownArrow', mods = 'ALT|SHIFT', action = act.SplitVertical {} },

  { key = 'LeftArrow', mods = 'CTRL', action = act.ActivatePaneDirection 'Left' },
  { key = 'RightArrow', mods = 'CTRL', action = act.ActivatePaneDirection 'Right' },
  { key = 'UpArrow', mods = 'CTRL', action = act.ActivatePaneDirection 'Up' },
  { key = 'DownArrow', mods = 'CTRL', action = act.ActivatePaneDirection 'Down' },

  { key = 't', mods = 'CTRL', action = act.SpawnTab 'DefaultDomain' },
  { key = 'w', mods = 'CTRL', action = act.CloseCurrentPane { confirm = false } },
  { key = 'w', mods = 'ALT', action = act.CloseCurrentTab { confirm = false } },
  { key = 'u', mods = 'CTRL', action = act.SendString('\\x15') },
}

键盘快捷键说明

快捷键	作用
Alt + Shift + →	水平分屏，向右新建 Pane
Alt + Shift + ↓	垂直分屏，向下新建 Pane
Ctrl + ←	切换到左侧 Pane
Ctrl + →	切换到右侧 Pane
Ctrl + ↑	切换到上方 Pane
Ctrl + ↓	切换到下方 Pane
Ctrl + t	新建标签页
Ctrl + w	关闭当前 Pane
Alt + w	关闭当前标签页
Ctrl + u	清空当前命令行输入
Ctrl + 1 ~ Ctrl + 8	切换到第 1 ~ 8 个标签页

WezTerm 鼠标操作

鼠标行为配置位于：

C:\Users\Administrator\.wezterm.lua

对应配置段：

config.mouse_bindings = {
  {
    event = { Down = { streak = 2, button = 'Left' } },
    mods = 'NONE',
    action = act.ToggleFullScreen,
  },
  {
    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),
  },
  {
    event = { Down = { streak = 1, button = 'Left' } },
    mods = 'ALT',
    action = act.StartWindowDrag,
  },
  {
    event = { Drag = { streak = 1, button = 'Left' } },
    mods = 'CTRL',
    action = act.StartWindowDrag,
  },
  {
    event = { Drag = { streak = 1, button = 'Left' } },
    mods = 'SHIFT',
    action = act.ExtendSelectionToMouseCursor('Cell'),
  },
}

鼠标操作说明

操作	作用
左键双击	切换全屏 / 退出全屏
右键单击，有选中文本时	复制选中文本到剪贴板
右键单击，无选中文本时	粘贴剪贴板内容
Alt + 左键单击	拖动窗口
Ctrl + 左键拖动	拖动窗口
Shift + 左键拖动	强制选择文本

修改后生效方式

如果修改的是 NuShell 配置，已经打开了 NuShell，可以执行：

source $nu.config-path

重新加载配置。

如果修改的是 WezTerm 配置，建议直接关闭当前 WezTerm 窗口，重新打开。