我的WezTerm配置

📖 项目简介

这是一个高度模块化的 WezTerm 终端配置项目,基于 QianSong1/wezterm-config 修改优化而来。

✨ 核心特性

• 🎨 多主题支持: Gruvbox / Catppuccin / Dracula / One Dark (一键切换)
• ⌨️ 丰富的快捷键: 窗格管理、标签切换、字体调整等
• 🔧 模块化设计: 清晰的配置分离,易于维护和扩展
• 💻 跨平台支持: 自动适配 Windows/macOS/Linux
• 🎯 自定义标签栏: 显示进程名、管理员标识、未读提醒
• 🚀 WebGPU 渲染: 高性能图形加速
• 📦 Nushell 集成: 完整的命令补全系统 (Git/Claude/Mise)
• ✨ Starship Prompt: 美观的跨 Shell 提示符

📂 项目结构

wezterm/
├── wezterm.lua              # 主入口文件 - 组装所有配置模块
├── config/                  # 核心配置目录
│   ├── init.lua            # Config 类 - 模块化配置管理器
│   ├── appearance.lua      # 外观配置(主题、窗口、标签栏)
│   ├── bindings.lua        # 键盘/鼠标绑定
│   ├── domains.lua         # 域配置(WSL、SSH等)
│   ├── fonts.lua           # 字体配置
│   ├── general.lua         # 通用行为配置
│   └── launch.lua          # 启动配置
├── events/                  # 事件处理目录
│   ├── tab-title.lua       # 自定义标签标题格式化
│   ├── right-status.lua    # 右侧状态栏
│   └── new-tab-button.lua  # 新建标签按钮
├── colors/                  # 颜色主题
│   └── custom.lua          # 自定义 Catppuccin Mocha 配色
├── utils/                   # 工具函数
│   ├── math.lua            # 数学工具
│   └── platform.lua        # 平台检测(Win/Mac/Linux)
├── nushell/                 # Nushell 补全和脚本
│   ├── custom-completions/ # 自定义命令补全
│   │   ├── git/            # Git 补全
│   │   ├── claude/         # Claude Code 补全
│   │   └── mise/           # Mise 工具管理器补全
│   ├── config.nu           # Nushell 配置文件
│   ├── COMPLETIONS_GUIDE.md # 补全资源指南
│   ├── MISE_COMPLETIONS_GUIDE.md # Mise 补全开发指南
│   └── STARSHIP_INTEGRATION_GUIDE.md # Starship 集成指南
├── backdrops/              # 背景图片
├── sync_to_user.bat        # WezTerm 配置同步脚本
└── sync_nushell_config.bat # Nushell 配置同步脚本

相关链接

• https://github.com/rxi/lume
• https://github.com/catppuccin/wezterm
• wezterm/wezterm#628 (comment)
• wezterm/wezterm#628 (reply in thread)
• https://github.com/wezterm/wezterm/releases/download/nightly/WezTerm-nightly-setup.exe
• https://github.com/starship/starship/releases/download/v1.25.1/starship-x86_64-pc-windows-msvc.msi
• https://github.com/nushell/nushell/releases/download/0.113.1/nu-0.113.1-x86_64-pc-windows-msvc.msi
• https://github.com/carapace-sh/carapace-bin/releases/download/v1.7.0/carapace-bin_1.7.0_windows_amd64.zip
• https://www.sqlite.org/2026/sqlite-tools-win-x64-3530200.zip

🛠️ 技术栈

• 配置语言: Lua (WezTerm 原生配置语言)
• 字体: JetBrains Mono Nerd Font
• 主题:
  • Gruvbox Dark (暖色调复古风格)
  • Catppuccin Mocha (紫色调现代风格)
  • Dracula (深蓝色调高对比度)
  • One Dark (Atom 编辑器风格)
• 图标: Nerd Fonts (Unicode 特殊字符)
• 渲染后端: WebGPU / OpenGL

📦 安装方法

前提条件

1. 安装 WezTerm 终端
2. 安装 Nerd Fonts (推荐 JetBrains Mono Nerd Font)

安装步骤

Windows

# 1. 克隆或下载本仓库
# 2. 将配置文件复制到以下目录
$HOME\.config\wezterm
# 例如: C:\Users\YourName\.config\wezterm

macOS / Linux

# 1. 克隆仓库
git clone https://github.com/long36708/wezterm-config.git ~/.config/wezterm

# 2. WezTerm 会自动加载配置

配置说明

• 配置文件修改后自动热重载,无需重启 WezTerm
• 主要配置入口: config/user_preferences.lua
• 可在其中快速切换主题、字体、快捷键风格等

🎨 快速定制

编辑 config/user_preferences.lua:

return {
   theme = "gruvbox",          -- 或 "catppuccin" | "dracula" | "one_dark"
   font_family = "jetbrains",  -- 或 "caskaydia", "fira_code"
   window_startup = "default", -- 或 "centered", "maximized"
   wsl_distros = {             -- 自定义 WSL 发行版
      { label = "Ubuntu", name = "Ubuntu" },
      { label = "Kali", name = "kali-linux" },
   },
}

🔄 快速切换主题 (三种方式)

方式1: F2 命令面板 (推荐) ⭐

1. 按 F2 打开命令面板
2. 输入 "gruv" → 选择 "🎨 切换到 Gruvbox"
3. 按回车 → 立即切换!

可用选项:

• 🎨 切换到 Gruvbox - 暖色调复古风格
• 🎨 切换到 Catppuccin - 紫色调现代风格
• 🎨 切换到 Dracula - 深蓝色调高对比度
• 🎨 切换到 One Dark - Atom 编辑器风格

方式2: 快捷键循环切换

按 Ctrl+Shift+Y 循环切换主题
顺序: gruvbox → catppuccin → dracula → one_dark → gruvbox → ...

方式3: 修改配置文件

-- 编辑 config/user_preferences.lua
theme = "dracula"  -- 修改为你喜欢的主题

💡 提示: 使用 F2 或快捷键切换后,配置会自动保存到文件,永久生效!

详细说明请查看 CONFIG_GUIDE.md

⌨️ 快捷键指南

基础操作

快捷键	功能
Ctrl+C	终止命令 (SIGINT)
Ctrl+Shift+C	复制
Ctrl+V	粘贴
Shift+Insert	粘贴
F11	全屏切换
Ctrl+Shift+R	重命名标签
Ctrl+Shift+Y	循环切换主题 ⭐

💡 重要: Ctrl+C 已恢复为标准的终止信号功能，不再用于复制

💡 提示: 按 Ctrl+Shift+Y 可快速在 4 个主题间循环切换

标签页管理

快捷键	功能
Alt+Ctrl+T	新建标签页 (WSL:Ubuntu)
Alt+Ctrl+W	关闭当前标签页
Alt+[ 或 Alt+h 或 Alt+←	切换到上一个标签
Alt+] 或 Alt+l 或 Alt+→	切换到下一个标签
Alt+Ctrl+[	向左移动标签
Alt+Ctrl+]	向右移动标签
Ctrl+T	新建标签页 (Chrome 风格)
Ctrl+W	关闭标签页 (Chrome 风格)
Ctrl+Tab	下一个标签页
Ctrl+Shift+Tab	上一个标签页
Ctrl+1~8	切换到第 1-8 个标签页

窗格管理

💡 快捷键说明: hjkl 为 vim 风格导航键，双手可在主键位不移进行方向操作（h=左、j=下、k=上、l=右）

快捷键	功能
Alt+Ctrl+\	水平拆分窗格 (左右)
Alt+Ctrl+/	垂直拆分窗格 (上下)
Alt+Ctrl+-	关闭当前窗格
Alt+Ctrl+Z	最大化/还原当前窗格
Alt+Ctrl+k	激活上方窗格
Alt+Ctrl+j	激活下方窗格
Alt+Ctrl+h	激活左侧窗格
Alt+Ctrl+l	激活右侧窗格
Alt+Ctrl+↑	向上扩展窗格
Alt+Ctrl+↓	向下扩展窗格
Alt+Ctrl+←	向左扩展窗格
Alt+Ctrl+→	向右扩展窗格

字体调整

快捷键	功能
Alt+↑	放大字体
Alt+↓	缩小字体
Alt+R	重置字体大小

Leader 键模式

激活方式: Ctrl+Shift+Space

激活后可使用组合键（hjkl 为 vim 风格导航键）:

按键	功能
f → k/j/r/q	字体调整模式 (放大/缩小/重置/退出)
p → h/j/k/l/q	窗格调整模式 (左/下/上/右/退出)

其他功能键

按键	功能
F1	进入复制模式
F2	命令面板
F3	启动器
F4	标签导航器
F12	调试控制台
Alt+F	搜索文本
Alt+N	新建窗口

F2 命令面板快捷入口

按 F2 后可直接输入关键词快速访问:

输入关键词	功能
gruv	🎨 切换到 Gruvbox
catp	🎨 切换到 Catppuccin
drac	🎨 切换到 Dracula
one	🎨 切换到 One Dark
配置	⚙️ 打开配置向导
验证	✅ 验证配置文件

鼠标操作

操作	功能
左键单击	选择文本
双击左键	选择单词
三击左键	选择整行
Ctrl+点击链接	打开链接
Alt+拖动	窗口拖动
滚轮	滚动屏幕
右键单击	智能复制/粘贴 ✨

💡 提示: 右键点击时,如果有选中文本则自动复制,否则自动粘贴

---

🐚 Nushell 集成

本项目包含完整的 Nushell 配置和命令补全系统。

📦 命令补全

已集成的补全模块:

• ✅ Git - 完整的 Git 命令补全
• ✅ Claude Code - Claude CLI 补全
• ✅ Mise - 多语言工具管理器补全 (100+ 命令)

查看完整文档:

• 补全使用指南
• Mise 补全开发指南

✨ Starship Prompt

支持 Starship 跨 Shell 提示符集成:

• 自动初始化 (Nushell v0.96+)
• 美观的 Git 状态显示
• 语言版本自动检测
• 高度可定制的主题

查看完整文档:

• Starship 集成指南

🔄 配置同步

# 同步 Nushell 配置到用户目录
.\sync_nushell_config.bat

# 同步 WezTerm 配置到用户目录
.\sync_to_user.bat