快速上手 WezTerm 终端美化:新手 10 分钟配置教程
【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by @wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm
终端的默认配色看久了发灰,SSH 窗口和本地窗口来回切,效率低得明显。WezTerm 是一个用 Rust 编写的 GPU 加速跨平台终端模拟器与多路复用器,这篇文章是一份面向新手的 WezTerm 配置教程,目标只有一个:10 分钟内装好它,并做出一次肉眼可见的个性化改变。
装好 WezTerm:每个平台最短的一条路
这一步解决"先跑起来"的问题。每个平台只给一条命令,装完就能打开窗口。
- Linux:用 Flatpak 装,装完
wezterm命令直接可用。
flatpak install flathub org.wezfurlong.wezterm- macOS:用 Homebrew 装 Cask。
brew install --cask wezterm- Windows:用 winget 装。
winget install WezTerm.WezTerm装好之后,先不急着写配置。WezTerm 启动时会按顺序找~/.wezterm.lua和~/.config/wezterm/wezterm.lua两个位置的配置文件,下面统一用~/.wezterm.lua,这是更省事的默认位置。
WezTerm 换主题的第一步
这一步解决"默认配色发灰"的问题:一行内置主题 + 十几行自定义颜色,是全文最快的"啊哈时刻"。
先选一个内置颜色方案,WezTerm 内置了 700 多种:
local wezterm = require 'wezterm' local config = wezterm.config_builder() -- 一行切换内置颜色方案 config.color_scheme = 'Dracula' return config如果你想完全控制颜色,就把colors块写出来,只挑几个常用字段:
config.colors = { background = '#101418', -- 背景 foreground = '#c5cdd8', -- 前景 cursor_bg = '#52ad70', -- 光标背景 cursor_fg = '#101418', -- 光标前景 selection_bg = '#2d3a4a', -- 选区背景 -- 基础 ANSI 颜色,8 个 ansi = { '#000000', '#cc0403', '#19cb00', '#cecb00', '#0d73cc', '#cb1ed1', '#0dcdcd', '#dddddd', }, -- 亮色 ANSI 颜色,8 个 brights = { '#767676', '#f2201f', '#23fd00', '#fffd00', '#1a8fff', '#fd28ff', '#14ffff', '#ffffff', }, }保存后按Super+R(macOS 上是Ctrl+Shift+R),配色立刻生效,不用重启窗口。标签页加渐变背景的效果长这样:
WezTerm 中文字体回退与行高设置
这一步解决两个观感问题:中文和符号偶发缺字,以及字符贴得太挤。
三行配置,各管一件事:
-- 字体回退列表:主字体缺的字,按顺序往后找 config.font = wezterm.font_with_fallback({ 'JetBrains Mono', 'Noto Sans CJK SC', -- 中文字体回退 'Noto Color Emoji', -- 彩色表情回退 }) config.font_size = 12 -- 字号,按屏幕调 config.line_height = 1.2 -- 行高,略大于 1 更透气WezTerm 自带捆绑了 JetBrains Mono、Nerd Font 符号和 Noto Color Emoji,所以即使在干净的系统上,回退列表里的英文和表情也不会缺字。不确定本机装了什么字体,用wezterm ls-fonts查一遍再填名字。
把一台机器当工作站:WezTerm 多路复用与 SSH 配置
这一步解决"窗口切来切去"的问题:分屏留在本地,远程会话通过 SSH 域接入,两边都可以继续分屏。
先定义 SSH 域,名字会出现在启动菜单和标签栏里:
-- 远程会话:在 ~/.ssh/config 已有密钥的情况下免密接入 config.ssh_domains = { { name = 'my.server', remote_address = '192.168.1.1', username = 'yourname', }, }再绑两组快捷键:分屏和快速选择。快速选择模式用于从屏幕上直接框选复制文本,不用拖鼠标:
config.keys = { -- 水平分屏:把当前窗格切成上下两块 { key = '%', mods = 'CTRL|SHIFT|ALT', action = wezterm.action.SplitHorizontal }, -- 垂直分屏:切成左右两块 { key = '"', mods = 'CTRL|SHIFT|ALT', action = wezterm.action.SplitVertical }, }分屏之后,用Ctrl+方向键在窗格之间移动焦点,Ctrl+Shift+Space进入快速选择模式,鼠标点一下就完成复制:
值得收藏的 5 条 WezTerm CLI
每一步都对应一个具体动作,遇到对应问题直接跑:
wezterm ls-fonts:列出本机可用字体,填字体回退列表前先查这个。wezterm imgcat <图片路径>:直接在终端里显示图片,不用切到文件管理器。wezterm ssh user@host:走 WezTerm 自己的 SSH 客户端开远程会话,远端也能享受分屏。wezterm cli list:列出所有活动窗口和标签页,多开时用来定位目标。wezterm --log-file debug.log:把日志写到debug.log,配置出问题时先看它。
imgcat的效果长这样,截图直接躺在终端里:
配置不生效时查这里
按顺序过一遍,四步之内基本都能定位问题:
- 先热重载:改完
~/.wezterm.lua按Super+R(macOS 为Ctrl+Shift+R)。大多数"没生效"其实是没重载。 - 看日志:用
wezterm --log-file debug.log启动,出问题时打开debug.log搜error。 - 查配置路径:确认你改的确实是
~/.wezterm.lua,而不是~/.config/wezterm/wezterm.lua里另一份旧的。 - 翻官方 FAQ:docs/faq.md 收录了常见报错和对应处理办法,配置项的完整说明在 docs/config/lua/ 下,每个字段都有独立页面。
下一步:把~/.wezterm.lua提交到你自己的 Git 仓库,改一次推一次,换机器时git clone下来就能还原全部配置。
【免费下载链接】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),仅供参考