WezTerm — Rust 写的 GPU 加速终端，配置用 Lua 还自带多路复用

是什么

WezTerm 是一个终端模拟器（terminal emulator）——就是你每天看到的那个黑底白字、能敲命令的窗口。日常类比：终端模拟器是”打字纸”，你敲的字符在上面显示，shell（bash/zsh/fish）才是真正帮你跑命令的”秘书”。

它和 macOS 自带的 Terminal.app、iTerm2、Alacritty、Kitty 是同一类东西，都是”画字符”的窗口程序。WezTerm 选了一组挺有特色的取舍：

用 Rust 写的（性能没 GC 抖动）
文字渲染走 GPU（每一帧字都是显卡画的，所以滚日志不卡）
配置文件用 Lua（不是 yaml/toml，是真脚本，可以写函数）
内置多路复用——不装 tmux 也能开 tab、分屏、远程会话挂起

一句话：把 Alacritty 的”快”、iTerm2 的”全”、tmux 的”多路复用”揉到一个跨平台二进制里。

为什么重要

不理解 WezTerm 的取舍，下面这些事会很困惑：

为什么有人说”我换了终端，cargo build 看着都快了”——其实编译没变快，是滚日志的渲染快了
为什么 Lua 写配置看着像炫技——其实是因为 yaml 写不出”早上用浅色主题、晚上自动换深色”
为什么明明有 tmux 还要”内置 mux”——跨机器场景下原生 SSH + mux 协议比层层 wrap 顺手
为什么 macOS / Linux / Windows 三个平台能用同一份配置——跨平台的终端模拟器其实很少

核心要点

WezTerm 的世界由这几个概念组成，从外到内：

window（窗口）：操作系统级别的窗口，可以多开
tab（标签页）：窗口里的标签，类比浏览器多 tab
pane（面板）：tab 内的分屏块，可以上下左右切
domain（域）：会话所在的”地方”——本地、SSH、Unix socket、串口都算一种 domain
multiplexer（多路复用器）：让会话脱离窗口存在的机制——关掉窗口会话还在，下次连回来继续。和 tmux 的”detach/attach”是同一类东西

特色机制：

GPU 渲染：把每个字符当成图形交给显卡画。用 wgpu crate（Rust 生态的 GPU 抽象层，Firefox/Bevy 也在用）封装 Metal/Vulkan/DX12 这些”和显卡说话的协议名”
Lua 配置：~/.config/wezterm/wezterm.lua 返回一张配置表，可以写函数、监听事件
图片协议三件套：iTerm2 inline、Kitty graphics、Sixel 都原生支持，终端里直接看图
连字（ligature）：用 harfbuzz，让 => != -> 显示成连起来的符号
内置 SSH：wezterm ssh user@host 走自带的 libssh2，不依赖系统 ssh 命令

实践案例

案例 1：第一次启动

brew install --cask wezterm    # macOS
# 或下载 .dmg / .msi / .deb

直接打开就能用，但默认字体偏大、配色偏暗，第一次会觉得”不如 Terminal.app 顺眼”——这是正常的，需要改 config。

案例 2：最小可用配置

~/.config/wezterm/wezterm.lua：

local wezterm = require 'wezterm'
local config = {}

config.font = wezterm.font 'JetBrains Mono'
config.font_size = 14
config.color_scheme = 'Catppuccin Mocha'
config.window_background_opacity = 0.95
config.hide_tab_bar_if_only_one_tab = true

return config

返回值是一张 Lua 表，wezterm 启动时读它。

案例 3：用 Lua 写”白天浅色、晚上深色”

yaml 写不出的事，Lua 一行搞定：

local function scheme_for_appearance(appearance)
  if appearance:find 'Dark' then
    return 'Catppuccin Mocha'
  else
    return 'Catppuccin Latte'
  end
end

config.color_scheme = scheme_for_appearance(wezterm.gui.get_appearance())

get_appearance 读系统当前是浅色还是深色模式，返回不同主题名。

多路复用怎么用

wezterm cli list                     # 看当前所有 mux 里的会话
wezterm cli spawn --domain-name unix # 在后台 mux domain 里开一个新窗格

后台启动 mux server，多个 wezterm 窗口连同一个 mux：

wezterm serve --daemonize     # 起后台
wezterm connect unix          # 另一个窗口连进来

效果类似 tmux detach/attach，但协议是原生的，不需要 wrapper。

踩过的坑

Lua 上手门槛：零基础以为会像 yaml 那么直白，结果第一次改配置查了半小时文档。值得花一晚上学 Lua 表语法
默认外观不讨喜：字号、字距、配色都偏开发者审美，第一次开会觉得”怎么这么糙”。改完 font + color_scheme 之后才正常
GPU 在远程 X11 / 虚拟机里退化：通过 X-forwarding 或在 VM 里跑时，GPU 优势消失，OpenGL fallback 反而比纯 CPU 终端慢
Windows ConPTY 历史 bug：早期版本在 Windows 偶尔遇到换行符吞字、光标错位。新版好多了但仍偶发
mux 协议跨版本不兼容：服务端和客户端版本差太多连不上。同一台机器装 brew 自动升级时会突然连不上自己开的 daemon

适用 vs 不适用场景

适用：

跨平台一致体验——macOS / Linux / Windows 用同一份 Lua 配置
字体连字、emoji、CJK 字符都要好看
想要内置 multiplex 但不想装 tmux/zellij
想要程序化配置（按时间/项目/主机切主题、键位）

不适用：

只用 macOS + 已经习惯 iTerm2，迁移收益小
极简主义——只要”画字符的窗口”就够，Alacritty 更对味
不愿学 Lua——改个配置都觉得累
主力机器没像样 GPU（远程 X11 / 老虚拟机）

替代品对比

Alacritty：同样 Rust+GPU 但极简——不带 tab、不带 mux、yaml 配置。“快但少”
Kitty：C+Python，性能接近，Python 配置；macOS/Linux 体验好但 Windows 缺席
iTerm2：仅 macOS，特性最齐，AppleScript 自动化强；不跨平台
Terminal.app：macOS 自带，简化版，能用就行的场景
tmux + Alacritty：把 mux 拆出来，组合更纯粹但要多装一层

经验法则：跨三平台选 WezTerm；只用 macOS + 已配好 iTerm2 留着用；要极致性能选 Alacritty + tmux。

学到什么

GPU 渲染文本是过去十年终端模拟器的范式转移——Alacritty 起头，Kitty 跟进，WezTerm 把它做成跨平台默认
Lua 当配置语言：比 yaml 灵活十倍，比写真插件门槛低十倍，是个被低估的中间形态
跨平台一致体验值钱——一套配置三处用，远超”在每台机器上重新配”的成本
把多个工具揉一锅（终端 + mux + SSH 客户端）是产品取舍——你失去模块化，换来开箱即用

历史小故事（可跳过）

2018 年：Wez Furlong（彼时 Facebook 工程师）开始写 WezTerm，名字就是 Wez+Term
2019 年：第一个公开版本，OpenGL 渲染
2020 年：加入 multiplexer server 模式
2022 年：迁移到 wgpu，支持 WebGPU 后端
现在：19k+ GitHub star，是 macOS 上 iTerm2 的主要跨平台替代候选

关联

zellij —— 同样 Rust 写的 mux，但只做 mux 不画像素
tmux —— 经典多路复用器，WezTerm 内置 mux 时常被对比
nushell —— 同样用 Rust 重写老工具的代表，设计取舍对照