WezTerm 实战：4 个配置项搞定 GPU 加速终端定制指南

WezTerm 实战：4 个配置项搞定 GPU 加速终端定制指南

【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by @wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm

WezTerm 是一款用 Rust 编写、由 GPU 加速渲染的跨平台终端模拟器，同时内置多路复用器。它把终端的外观与行为几乎全部交给一个 Lua 文件决定：配色、窗格、背景、快捷键，都可以用配置改。这篇指南不追求花哨，只讲 4 个最实用的配置点——换配色、管窗格、上背景、让主题自动切换——每改一项，终端观感都会明显不同。

🎨 终端配色：一行配置换肤，也能逐色微调

WezTerm 内置了上千套配色方案（完整清单见 docs/colorschemes/data.json），换肤只需一行：

local wezterm = require 'wezterm' local config = {} config.color_scheme = 'Catppuccin Mocha' -- 不想完全照搬方案时，可单独覆盖任意颜色 config.colors = { foreground = '#d9e0ee', cursor_bg = '#89b4fa', } return config

把color_scheme换成方案名即可整体换肤；colors字段则负责细节修正，foreground、background、cursor_bg、ansi等都能单独指定。颜色值支持#RRGGBB、hsl:、rgba()等写法，透明度也是内置的，不需要额外处理。

改完配置后终端会自动重载，不用重启。

🧩 多窗格布局：分割、导航与焦点管理

WezTerm 自带多路复用能力，默认快捷键如下（完整键位见 docs/config/keys.md）：

布局本身只是效率工具，真正提升观感的是"焦点感"。设置config.inactive_pane_hsb后，非活跃窗格会自动降饱和、降亮度：把saturation和brightness调到 0.6~0.8 之间，视线会自然落在当前窗格上，其余窗格退成背景信息。这两个参数各占一行配置，没有代码块，直接加进配置文件即可。

🌌 背景效果：渐变与背景图二选一

纯色背景不是唯一选项。渐变背景只需一个字段：

config.window_background_gradient = { orientation = 'Vertical', colors = { '#1a1b26', '#24283b' }, interpolation = 'Linear', noise = 0.0, }

orientation可选方向，colors给两个以上色值即可做出层次，noise控制噪点强度。官方截图里就有竖版和径向两种渐变效果可参考：

如果想用图片，则设置config.window_background_image指向图片路径，再用config.window_background_image_hsb给图片降亮度、降饱和，避免文字难以阅读。另外在 macOS 上开启背景模糊/材质效果（如亚克力），可以让桌面壁纸透进终端，效果见下图：

⚡ 主题自动化：跟随系统外观与项目目录

配色还可以"动态化"。根据系统深色/浅色外观选方案：

local function pick(appearance) return appearance:find 'Dark' and 'Catppuccin Mocha' or 'Solarized (Light)' end config.color_scheme = pick(wezterm.gui.get_appearance())

再进一步，按工作目录切主题：监听window-config-reloaded事件，读取当前窗格目录，对匹配的项目调用window:set_config_overrides传入不同的color_scheme。这样切到前端仓库用深色、切到文档仓库用浅色，全程不需要手动操作。

上手第一步

第一步很简单：找到配置文件~/.wezterm.lua（Windows 在%USERPROFILE%\.wezterm.lua），只写config.color_scheme一行，选一个顺眼的方案名保存，重载后就能看到效果。之后按上面的顺序逐项加：窗格变暗 → 背景渐变 → 自动主题。

更多配置项可查 docs/config/lua/ 下的逐条说明，功能总览在 docs/features.md，安装方式见 docs/installation.md。需要源码时执行git clone https://gitcode.com/GitHub_Trending/we/wezterm即可获取完整仓库。

【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by @wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm