WezTerm 配置实战用一份 Lua 把默认终端改造成高效工作流【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm先说一个真实场景屏幕上四个终端窗口——一个跑构建日志、一个挂着远端 ssh、一个本地测试、一个随手敲命令。合上笔记本再打开你忘了哪个窗口还活着日志被新输出冲掉还得重新cd回刚才的目录。问题的根源不在你手慢而在那个默认什么都不管的终端窗口管理器上。GPU 加速终端 WezTerm 本身就是为这类问题准备的它自带多路复用multiplexer一个窗口里管理多个窗格/标签而且几乎每个行为都能用 Lua 脚本接管。下面讲的是一份个性化配置的完整思路分三层推进先有一份能跑的最小配置再分别动视觉层、操作层和状态层最后做跨平台分支和验收。 5 分钟落一份最小可用的 .wezterm.lua默认配置的问题只有一个它对所有场景一视同仁没有你的这个变量。在 home 目录下新建~/.wezterm.lua只放五项local wezterm require wezterm local config wezterm.config_builder() config.initial_cols 120 config.initial_rows 32 -- 宽行日志少滚屏 config.font_size 13.0 config.scrollback_lines 20000 -- 默认值遇到长构建日志不够翻 config.color_scheme Tokyonight Night return config启动wezterm看到窗口按你的尺寸打开、配色生效就算过关。改完不需要重启进程它会自动重载automatically_reload_config默认为 true。小技巧配色名不记得拼写时先填一个错的名字看报错它会把相近的合法名列出来给你对。 字体回退链和透明度视觉层的第一刀默认字体的好是无感的通用缺的是等宽字体最该有的辨识度——连字、emoji、powerline 符号这些细节全看字体栈。config.font wezterm.font(JetBrains Mono) -- 回退链缺什么字形去找下一把字体 config.font_rules { { pattern { Font Noto Color Emoji } }, }为什么默认值不够好系统默认字体碰到 emoji 和 Nerd Font 符号会画豆腐块回退链就是告诉它缺字时去哪找。配色上不用自己调 16 色——内置了 1000 多个命名方案挑一个反复用就行color_scheme底色观感适合Catppuccin Mocha偏紫的深灰低对比、不刺眼长时间写代码Tokyonight Night冷色深蓝干净克制日常主力GitHub Dark中性深灰熟悉感强看 diff / 代码审查透明度是 Linux 上最值的一项默认窗口是不透明白箱桌面被它整个盖死config.window_background_opacity 0.92 config.kde_window_background_blur true⌨️ Leader 键工作流把窗格切换练成肌肉记忆默认快捷键只覆盖了基本盘窗格方向切换得靠鼠标点边框一快起来就废了。Leader 键前缀键的思路来自 Vim先按一个起手式松开再按第二个键组合空间立刻翻倍。config.leader { key A, mods CTRL, timeout_milliseconds 1200 } config.keys { -- CtrlA 之后 1.2 秒内接方向 { key h, mods LEADER, action wezterm.action.ActivatePaneFocus { Direction Left } }, { key l, mods LEADER, action wezterm.action.ActivatePaneFocus { Direction Right } }, { key |, mods LEADER|SHIFT, action wezterm.action.SplitHorizontal { domain CurrentPaneDomain } }, }日常动线就一条按CtrlA起手窗口左上角会亮一下提示已激活1.2 秒没接招就自动释放接h/l把焦点在窗格之间横着走方向键同理可以绑j/k上下走接 Shift|把当前窗格一分为二左跑日志、右跑 shell全程手指不离主键盘区鼠标只留给选文字。小技巧timeout 调短到 800 毫秒误触 Leader 的挫败感会明显下降。 状态栏让窗口标题不再只有一行wezhost:~默认标题栏只告诉你是谁在哪不告诉你现在是几点、我在哪个工作区多窗口一多就串味。WezTerm 提供了update-status钩子可以往左中右三个状态区写任意富文本config.status_update_interval 1000 -- 每秒刷新一次 wezterm.on(update-status, function(window, pane) local s wezterm.strftime(%H:%M:%S) .. .. pane:get_workspace_name() .. .. pane:pane_process_name() window:set_right_status(wezterm.format({ { Foreground { Color #c8d3f5 } }, { Text s }, })) end)为什么值得加多 tab 布局下状态栏是比 tab 标题更便宜的位置信息扫一眼就知道当前窗口属于哪个任务。渲染开销顺手收一下。WezTerm 默认走 WebGpu但帧率上限和滚屏量是可以控制的config.front_end WebGpu -- 掉帧就改 OpenGL config.max_fps 120 -- 封顶省电 config.visual_bell { fade_in_function EaseIn } config.audible_bell Disabled -- 构建告警别再震耳朵小技巧Linux 上偶尔出现撕裂把front_end切回OpenGL通常立刻消失代价是失去部分新特性。 按平台分支一份配置通吃 Windows / macOS / Linux同一份配置直接拷到三台机器会翻车默认 shell、模糊、装饰方式各不相同。Lua 本来就是脚本直接用target_triple做条件分支if wezterm.target_triple:find(windows) then config.default_prog { pwsh } config.window_background_opacity 0.97 elseif wezterm.target_triple:find(apple) then config.macos_window_background_blur 25 -- 毛玻璃 else -- Linux config.enable_wayland true end为什么不用三份配置文件分支写在一起改一处三端生效也不用维护哪个平台那份是最新的这种心智负担。小技巧在 Linux 上把enable_wayland留成 false 时可配合x11_embed_into_parent嵌进平铺窗口管理器如 sway。 排错与验收出了问题往哪查改完别凭感觉说应该没问题按这份清单过一遍再收工启动时终端没有报config load相关的 Lua 报错窗口按initial_cols×initial_rows打开渲染走 GPU日志里能看到 WebGpu/OpenGL 初始化记录拖动窗口无撕裂输入一串 emoji 和一个 powerline 箭头➜回退链兜住了没有豆腐块Leader 序列CtrlA→l能在 1 秒内把焦点移到右边窗格误触不会卡住键盘状态栏每 1000 毫秒刷新一次时间、工作区、进程名三者都对得上wezterm cli list能列出当前 mux 域多路复用通道正常。验收过了之后三件事值得做把~/.wezterm.lua放进版本控制每次改动一个提交翻车了git checkout秒回换机器时只拷这一个文件字体名对不上时先看 Lua API 参考 里 font 相关的条目配置读不懂的地方直接翻 官方配置文档每个字段的默认值和含义都在里面。改完这一轮下次打开的不再是一个终端而是你自己的工作台——从CtrlA起手的那一刻开始。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 WezTerm 配置实战：用一份 Lua 把默认终端改造成高效工作流
WezTerm 配置实战用一份 Lua 把默认终端改造成高效工作流【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm先说一个真实场景屏幕上四个终端窗口——一个跑构建日志、一个挂着远端 ssh、一个本地测试、一个随手敲命令。合上笔记本再打开你忘了哪个窗口还活着日志被新输出冲掉还得重新cd回刚才的目录。问题的根源不在你手慢而在那个默认什么都不管的终端窗口管理器上。GPU 加速终端 WezTerm 本身就是为这类问题准备的它自带多路复用multiplexer一个窗口里管理多个窗格/标签而且几乎每个行为都能用 Lua 脚本接管。下面讲的是一份个性化配置的完整思路分三层推进先有一份能跑的最小配置再分别动视觉层、操作层和状态层最后做跨平台分支和验收。 5 分钟落一份最小可用的 .wezterm.lua默认配置的问题只有一个它对所有场景一视同仁没有你的这个变量。在 home 目录下新建~/.wezterm.lua只放五项local wezterm require wezterm local config wezterm.config_builder() config.initial_cols 120 config.initial_rows 32 -- 宽行日志少滚屏 config.font_size 13.0 config.scrollback_lines 20000 -- 默认值遇到长构建日志不够翻 config.color_scheme Tokyonight Night return config启动wezterm看到窗口按你的尺寸打开、配色生效就算过关。改完不需要重启进程它会自动重载automatically_reload_config默认为 true。小技巧配色名不记得拼写时先填一个错的名字看报错它会把相近的合法名列出来给你对。 字体回退链和透明度视觉层的第一刀默认字体的好是无感的通用缺的是等宽字体最该有的辨识度——连字、emoji、powerline 符号这些细节全看字体栈。config.font wezterm.font(JetBrains Mono) -- 回退链缺什么字形去找下一把字体 config.font_rules { { pattern { Font Noto Color Emoji } }, }为什么默认值不够好系统默认字体碰到 emoji 和 Nerd Font 符号会画豆腐块回退链就是告诉它缺字时去哪找。配色上不用自己调 16 色——内置了 1000 多个命名方案挑一个反复用就行color_scheme底色观感适合Catppuccin Mocha偏紫的深灰低对比、不刺眼长时间写代码Tokyonight Night冷色深蓝干净克制日常主力GitHub Dark中性深灰熟悉感强看 diff / 代码审查透明度是 Linux 上最值的一项默认窗口是不透明白箱桌面被它整个盖死config.window_background_opacity 0.92 config.kde_window_background_blur true⌨️ Leader 键工作流把窗格切换练成肌肉记忆默认快捷键只覆盖了基本盘窗格方向切换得靠鼠标点边框一快起来就废了。Leader 键前缀键的思路来自 Vim先按一个起手式松开再按第二个键组合空间立刻翻倍。config.leader { key A, mods CTRL, timeout_milliseconds 1200 } config.keys { -- CtrlA 之后 1.2 秒内接方向 { key h, mods LEADER, action wezterm.action.ActivatePaneFocus { Direction Left } }, { key l, mods LEADER, action wezterm.action.ActivatePaneFocus { Direction Right } }, { key |, mods LEADER|SHIFT, action wezterm.action.SplitHorizontal { domain CurrentPaneDomain } }, }日常动线就一条按CtrlA起手窗口左上角会亮一下提示已激活1.2 秒没接招就自动释放接h/l把焦点在窗格之间横着走方向键同理可以绑j/k上下走接 Shift|把当前窗格一分为二左跑日志、右跑 shell全程手指不离主键盘区鼠标只留给选文字。小技巧timeout 调短到 800 毫秒误触 Leader 的挫败感会明显下降。 状态栏让窗口标题不再只有一行wezhost:~默认标题栏只告诉你是谁在哪不告诉你现在是几点、我在哪个工作区多窗口一多就串味。WezTerm 提供了update-status钩子可以往左中右三个状态区写任意富文本config.status_update_interval 1000 -- 每秒刷新一次 wezterm.on(update-status, function(window, pane) local s wezterm.strftime(%H:%M:%S) .. .. pane:get_workspace_name() .. .. pane:pane_process_name() window:set_right_status(wezterm.format({ { Foreground { Color #c8d3f5 } }, { Text s }, })) end)为什么值得加多 tab 布局下状态栏是比 tab 标题更便宜的位置信息扫一眼就知道当前窗口属于哪个任务。渲染开销顺手收一下。WezTerm 默认走 WebGpu但帧率上限和滚屏量是可以控制的config.front_end WebGpu -- 掉帧就改 OpenGL config.max_fps 120 -- 封顶省电 config.visual_bell { fade_in_function EaseIn } config.audible_bell Disabled -- 构建告警别再震耳朵小技巧Linux 上偶尔出现撕裂把front_end切回OpenGL通常立刻消失代价是失去部分新特性。 按平台分支一份配置通吃 Windows / macOS / Linux同一份配置直接拷到三台机器会翻车默认 shell、模糊、装饰方式各不相同。Lua 本来就是脚本直接用target_triple做条件分支if wezterm.target_triple:find(windows) then config.default_prog { pwsh } config.window_background_opacity 0.97 elseif wezterm.target_triple:find(apple) then config.macos_window_background_blur 25 -- 毛玻璃 else -- Linux config.enable_wayland true end为什么不用三份配置文件分支写在一起改一处三端生效也不用维护哪个平台那份是最新的这种心智负担。小技巧在 Linux 上把enable_wayland留成 false 时可配合x11_embed_into_parent嵌进平铺窗口管理器如 sway。 排错与验收出了问题往哪查改完别凭感觉说应该没问题按这份清单过一遍再收工启动时终端没有报config load相关的 Lua 报错窗口按initial_cols×initial_rows打开渲染走 GPU日志里能看到 WebGpu/OpenGL 初始化记录拖动窗口无撕裂输入一串 emoji 和一个 powerline 箭头➜回退链兜住了没有豆腐块Leader 序列CtrlA→l能在 1 秒内把焦点移到右边窗格误触不会卡住键盘状态栏每 1000 毫秒刷新一次时间、工作区、进程名三者都对得上wezterm cli list能列出当前 mux 域多路复用通道正常。验收过了之后三件事值得做把~/.wezterm.lua放进版本控制每次改动一个提交翻车了git checkout秒回换机器时只拷这一个文件字体名对不上时先看 Lua API 参考 里 font 相关的条目配置读不懂的地方直接翻 官方配置文档每个字段的默认值和含义都在里面。改完这一轮下次打开的不再是一个终端而是你自己的工作台——从CtrlA起手的那一刻开始。【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考