WezTerm 快速上手指南：配置 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 加速跨平台终端模拟器与多路复用器，支持 Linux、macOS、Windows、FreeBSD 和 NetBSD。下面用三个最小配置，覆盖最常见的三类需求：换配色、换背景、分窗格。
项目速览
- Rust 实现，GPU 加速渲染，跨平台运行：docs/features.md
- 内置 700 多种颜色方案，Lua 配置，改动后自动热重载
- 本地与远程多路复用：窗格、标签、窗口，带原生鼠标与滚动回看
- 支持 SSH 客户端、串口连接、图片协议（imgcat / Kitty / Sixel）
按场景看能力
场景一：给终端换一套配色
你遇到的情况：默认的白字黑底用腻了，想换成更顺眼的配色，但又不想手动指定 16 种颜色。
WezTerm 的解法：在配置文件里写一行color_scheme，从内置方案里挑一个即可，保存后窗口自动刷新生效。
这段配置的作用：应用内置的 "Batman" 配色方案，其余保持默认。
local wezterm = require 'wezterm' local config = wezterm.config_builder() config.color_scheme = 'Batman' return config全部可选方案的清单和预览图见 docs/colorschemes/data.json，配色机制的细节见 docs/config/appearance.md。
场景二：把纯色背景换成渐变或图片
你遇到的情况：终端长时间开着，纯黑背景略显单调；或者想放一张暗色壁纸垫底，又怕盖过文字。
WezTerm 的解法：window_background_gradient支持垂直/径向渐变，window_background_image支持任意图片，并可用 HSB 参数压暗，保证前景文字可读。
这段配置的作用：设置一个三色垂直渐变背景；第二处配置改用图片并压暗降低饱和度。
config.window_background_gradient = { orientation = 'Vertical', colors = { '#0f0c29', '#302b63', '#24243e' }, } config.window_background_image = '/path/to/bg.png' config.window_background_image_hsb = { brightness = 0.3, saturation = 0.8 }场景三：编辑器、日志、文档分屏并行
你遇到的情况：一边写代码，一边看构建日志，再挂一个远程会话，多个终端窗口来回切换很碎。
WezTerm 的解法：内置多路复用。Ctrl-Shift-Alt-%与Ctrl-Shift-Alt-"分别做竖直/水平分割，Ctrl-Shift-ArrowKey在窗格间移动，Super-T新建标签页。
这段配置的作用：把非活动窗格的饱和度与亮度各降到 70% 和 60%，让当前工作区一眼可辨。
config.inactive_pane_hsb = { saturation = 0.7, brightness = 0.6, }新手上手路径
10 分钟能做什么
- 按 docs/installation.md 安装对应平台的预编译版本。
- 在家目录新建
.wezterm.lua，放入上文 4 行的最小配置。 - 加一行
config.color_scheme = 'Batman'应用配色方案。 - 用
Ctrl-Shift-Alt-%分割第一个窗格，完成分屏。
之后可以深入什么
- 给窗口加上背景渐变或图片，参考 docs/config/appearance.md。
- 保存任意配置改动，WezTerm 自动热重载，可反复试验而不必重启终端。
- 需要按项目切配色时，阅读 Lua API 文档目录 docs/config/lua/ 学习事件钩子。
- 远程机管理改用 SSH 客户端模式（原生标签），见 docs/ssh.md。
常见坑
- 现象：改了配色没反应。原因：
color_scheme与colors互斥，配了方案后自定义的colors会被覆盖。解法：只留一种，或参考 docs/config/appearance.md 的 "Precedence" 一节合并配置。 - 现象：保存后配置一直不生效。原因：Lua 语法写错，热重载失败，窗口沿用旧配置。解法：按 docs/config/files.md 检查文件位置与语法，修正后自动重新加载。
- 现象：找不到配置文件。原因：Linux 上写到了
.config/wezterm/以外的位置。解法：新手直接放$HOME/.wezterm.lua，这是官方推荐的起步位置。
下一步
- 官方文档：docs/
- 配置参考：docs/config/files.md
- Lua API 参考：docs/config/lua/
- 核心源码：config/src/
配置改完保存即可生效，多试几次，你会很快有一套顺手的终端。
【免费下载链接】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），仅供参考
