1. 为什么要在 Win11 上折腾 WezTerm 加 PowerShell如果你跟我一样每天在 Windows 上敲命令的时间比点鼠标还多那大概率会对系统自带的 Windows Terminal 有那么点“能用但不够爽”的感觉。字体渲染偶尔发虚、分屏逻辑不够顺手、配置同步全靠手动复制 JSON换台机器就得重新来一遍。我前后试过 Tabby、Alacritty、Fluent Terminal 这些最后稳定留在 WezTerm 上核心原因就一个它是用 Rust 写的GPU 加速渲染配置文件用 Lua跨平台一套配置通吃而且主题同步这件事它能做得非常优雅。这篇内容就是把我自己在 Win11 上把 WezTerm 配成 PowerShell 默认终端、并且让主题在多设备之间自动同步的完整过程拆开讲。涉及的东西包括WezTerm 的安装与基础配置、PowerShell 7 的接入、字体与渲染调优、Lua 配置文件的模块化组织、主题同步的几种可行方案以及我在这个过程中踩过的坑。适合已经对终端有基本使用需求、想从默认终端迁移到更高效工具的人也适合已经在用 WezTerm 但配置还停留在“能用就行”阶段的朋友。先说清楚一件事WezTerm 不是那种装完就能无脑用的终端它的默认配置相当朴素甚至可以说有点丑。但它的可配置深度是同类工具里数一数二的你愿意花时间调它就能变成你每天最顺手的那个工具。下面我按实际操作的顺序来展开每一步都说明为什么这么做以及我试过哪些不太行的方案。2. 环境准备与 WezTerm 安装的细节考量2.1 Win11 下的安装方式选择WezTerm 在 Windows 上的安装方式主要有三种官网直接下载 MSI 安装包、通过 winget 安装、通过 Scoop 安装。我推荐用 winget原因是它跟 Win11 的集成度最好后续升级一条命令就搞定不用每次去官网看有没有新版本。winget install wez.wezterm装完之后你可以在开始菜单里找到 WezTerm但先别急着打开。这里有个细节WezTerm 默认会把自己注册成一个终端选项但不会自动替换掉系统默认终端。Win11 的默认终端设置藏在“设置 系统 开发者选项”或者直接搜索“默认终端应用”里你需要手动把默认终端应用改成 WezTerm。这一步不做的话你右键“在终端中打开”还是会弹出 Windows Terminal。注意如果你之前装过 Windows Terminal 的预览版默认终端设置里可能会出现多个条目认准 WezTerm 那个带图标的选择就行。2.2 PowerShell 7 的安装与版本确认系统自带的 Windows PowerShell 5.1 虽然能用但语法特性和性能都落后了。PowerShell 7 是跨平台版本基于 .NET Core启动更快对 UTF-8 的支持也更完善。安装同样走 wingetwinget install Microsoft.PowerShell装完之后在 WezTerm 里执行pwsh应该能直接进入 PowerShell 7。如果你不确定当前用的是哪个版本用$PSVersionTable看一眼就清楚了。我建议把 PowerShell 7 设为 WezTerm 的默认启动 shell而不是继续用 5.1原因后面讲配置的时候会提到。2.3 字体准备为什么 Nerd Font 是刚需WezTerm 本身对字体没什么特殊要求但如果你想让终端里的图标、Powerline 符号、Git 状态提示正常显示就必须装一个 Nerd Font。我试过不装 Nerd Font 直接用 Consolas结果 starship 提示符里的分支图标全变成方块看着非常难受。推荐用 JetBrainsMono Nerd Font 或者 CaskaydiaCove Nerd Font前者字形偏紧凑后者更接近 Windows 原生字体的观感。下载下来解压全选字体文件右键“为所有用户安装”即可。装完之后在 WezTerm 配置里指定字体名称注意名称要写对比如JetBrainsMono Nerd Font少一个空格都可能识别不到。3. WezTerm 配置文件的结构化组织3.1 配置文件放哪里、叫什么名字WezTerm 在 Windows 上读取配置文件的路径是%USERPROFILE%\.wezterm.lua也就是C:\Users\你的用户名\.wezterm.lua。这个文件默认不存在需要你自己创建。我建议不要把所有配置都堆在一个文件里而是拆成几个模块用 Lua 的require来组织。这样做的好处是主题同步的时候只需要同步主题相关的那个文件不会把整个配置都搅在一起。我的目录结构是这样的.wezterm.lua -- 入口文件负责加载其他模块 wezterm/ core.lua -- 基础设置字体、窗口、滚动 keys.lua -- 快捷键绑定 theme.lua -- 主题与配色 shells.lua -- shell 启动配置入口文件里用require加载local wezterm require(wezterm) local config wezterm.config_builder() require(wezterm.core)(config) require(wezterm.keys)(config) require(wezterm.theme)(config) require(wezterm.shells)(config) return config这里有个坑要注意require的路径是相对于 WezTerm 的配置目录的不是相对于当前文件。所以wezterm/core.lua这个写法是对的但如果你把文件放在别的地方路径就要相应调整。我一开始把模块放在.config/wezterm/下面结果一直报找不到模块后来才搞明白路径规则。3.2 基础配置里必须调的几个参数core.lua里我重点调了这几个东西。字体部分config.font wezterm.font(JetBrainsMono Nerd Font, { weight Medium }) config.font_size 11.5 config.line_height 1.15line_height这个参数很多人会忽略默认值 1.0 在高分屏上看起来行距偏紧调到 1.1 到 1.2 之间阅读舒适度会明显提升。font_size也不要盲目调大11 到 12 之间配合 Win11 的缩放比例通常比较合适。窗口和渲染部分config.window_background_opacity 0.95 config.win32_system_backdrop Acrylic config.front_end WebGpu config.max_fps 120front_end选 WebGpu 是因为它在 Win11 上的渲染效率比默认的 OpenGL 更好尤其是多标签页切换的时候掉帧更少。win32_system_backdrop设成 Acrylic 能启用 Win11 的亚克力模糊效果配合透明度看起来很有质感。但如果你用的是核显或者老显卡建议把front_end改回默认不然可能出现渲染异常。滚动缓冲我设成了 10000 行默认的 3500 行在跑编译输出或者日志的时候经常不够用config.scrollback_lines 100003.3 快捷键绑定的实用调整WezTerm 默认的快捷键跟 Windows Terminal 有不少冲突比如分屏是CtrlShiftAlt方向键按起来非常别扭。我在keys.lua里改成了更顺手的组合config.keys { { key d, mods CTRL|SHIFT, action wezterm.action.SplitHorizontal({ domain CurrentPaneDomain }) }, { key e, mods CTRL|SHIFT, action wezterm.action.SplitVertical({ domain CurrentPaneDomain }) }, { key w, mods CTRL|SHIFT, action wezterm.action.CloseCurrentPane({ confirm false }) }, { key h, mods CTRL|SHIFT, action wezterm.action.ActivatePaneDirection(Left) }, { key l, mods CTRL|SHIFT, action wezterm.action.ActivatePaneDirection(Right) }, }这套绑定逻辑跟 Vim 的方向习惯一致h往左、l往右用习惯了之后分屏切换几乎不用思考。CloseCurrentPane的confirm设成 false 是因为我经常误触每次弹确认框太烦索性关掉反正终端里也没什么不能重来的操作。4. 把 PowerShell 7 配成默认 Shell 的完整流程4.1 默认启动 Shell 的设置方法在shells.lua里指定默认程序config.default_prog { pwsh.exe, -NoLogo }-NoLogo参数能去掉 PowerShell 启动时那段版权信息让终端打开更干净。如果你想让 WezTerm 启动时直接进入某个目录可以加上-WorkingDirectory参数但我不建议写死因为不同项目目录不一样用zoxide或者Set-Location在 shell 里跳转更灵活。这里有个容易踩的坑如果你装了 PowerShell 7 但pwsh.exe不在 PATH 里WezTerm 会启动失败并直接闪退。确认方法是在 Win11 的“设置 系统 系统信息 高级系统设置 环境变量”里检查 PATH 是否包含 PowerShell 7 的安装目录通常是C:\Program Files\PowerShell\7。4.2 PowerShell 7 的 Profile 配置要点WezTerm 只负责启动 shell真正让终端好用的还是 shell 本身的配置。PowerShell 7 的 profile 文件路径可以用$PROFILE查看通常在Documents\PowerShell\Microsoft.PowerShell_profile.ps1。我在这份 profile 里做了几件事第一设置 UTF-8 编码避免中文乱码[Console]::OutputEncoding [System.Text.Encoding]::UTF8 $OutputEncoding [System.Text.Encoding]::UTF8第二引入 starship 提示符。starship 是跨 shell 的提示符工具配置一次到处能用Invoke-Expression (starship init powershell)第三设置一些常用别名和函数比如ll对应Get-ChildItem -Force..对应Set-Location ..。这些看起来是小东西但每天敲几百次命令的时候省下来的时间很可观。提示PowerShell 7 的执行策略默认可能是 Restricted导致 profile 无法加载。用Set-ExecutionPolicy -Scope CurrentUser RemoteSigned改一下就行这个操作只影响当前用户不需要管理员权限。4.3 启动速度优化别让 profile 拖慢终端PowerShell 7 的 profile 如果写得太重每次开终端都要等一两秒体验很差。我实测下来starship 初始化大概占 100 到 200 毫秒zoxide 初始化差不多但如果再加载一堆模块启动时间就会飙到一秒以上。优化思路是把不必要的东西延迟加载。比如posh-git这种模块可以只在进入 Git 仓库时才加载而不是每次启动都加载。另外Import-Module能少用就少用很多功能用原生命令或者简单的函数就能替代。我现在的 profile 加载时间稳定在 300 毫秒以内开终端基本是秒开。5. 主题同步的几种方案与实操对比5.1 为什么主题同步是个值得解决的问题我平时在两台机器上用 WezTerm一台台式机一台笔记本如果主题配置不同步每次换机器都要重新调一遍配色非常烦。主题同步的核心诉求其实就两个配色方案一致、字体和渲染参数一致。至于快捷键和 shell 配置那些可以各机器不同但视觉层面的一致性对使用体验影响很大。5.2 方案一Git 仓库同步整个配置目录最直接的办法是把整个.wezterm.lua和wezterm/目录放进一个 Git 仓库两台机器都 clone 下来改完 push另一台 pull。这个方案的好处是简单、可控、版本可追溯。坏处是如果两台机器的屏幕分辨率或者缩放比例不同字体大小这类参数可能需要分别调整每次 pull 都会覆盖掉本地修改。我的做法是在core.lua里根据屏幕尺寸动态设置字体大小local screen wezterm.gui.screens().active if screen.width 2560 then config.font_size 12.5 else config.font_size 11.0 end这样同一份配置在不同机器上都能有合适的显示效果不用手动改来改去。5.3 方案二用 Lua 模块做主题切换WezTerm 内置了不少配色方案可以用config.color_scheme直接指定。我习惯把主题相关的配置单独放在theme.lua里并且定义一个主题列表用快捷键循环切换local schemes { Catppuccin Mocha, Tokyo Night, Gruvbox Dark } local current 1 return function(config) config.color_scheme schemes[current] config.keys config.keys or {} table.insert(config.keys, { key t, mods CTRL|SHIFT, action wezterm.action_callback(function(window, pane) current current % #schemes 1 window:set_config_overrides({ color_scheme schemes[current] }) end), }) end这个方案适合喜欢经常换配色的人但要注意set_config_overrides只对当前窗口生效新开的窗口还是会用配置文件里的默认主题。如果你想让切换持久化还是得改配置文件本身。5.4 方案三用外部工具生成主题配置如果你对配色有更精细的要求比如想根据系统壁纸自动生成终端配色可以用pywal这类工具生成配色文件然后让 WezTerm 读取。具体做法是让 pywal 输出一个 Lua 文件在theme.lua里dofile加载它。这个方案的可玩性最高但配置链路也最长适合愿意折腾的人。我试过一段时间后来觉得维护成本太高就放弃了还是手动选几个顺眼的配色方案更省事。6. 常见问题与排查技巧实录6.1 终端启动闪退或报错最常见的原因是配置文件语法错误。Lua 的报错信息有时候不太直观如果 WezTerm 启动就闪退先用wezterm --config-file NUL启动一个不带配置的实例确认是配置问题还是程序本身的问题。然后逐段注释掉配置内容定位到具体哪一行出错。我遇到过一次是因为在config_builder之前就调用了config.font顺序错了导致整个配置加载失败。6.2 中文显示乱码或宽度异常这个问题通常有两个原因字体不支持中文或者编码设置不对。字体方面Nerd Font 本身对中文的支持有限建议在font配置里加一个中文回退字体config.font wezterm.font_with_fallback({ JetBrainsMono Nerd Font, Microsoft YaHei, })编码方面确保 PowerShell 7 的 profile 里设置了 UTF-8同时 WezTerm 的default_prog不需要额外加编码参数它默认就是 UTF-8。6.3 主题同步后字体渲染不一致两台机器如果缩放比例不同同样的font_size看起来大小会不一样。解决办法是用wezterm.gui.screens()获取当前屏幕的 DPI 信息动态计算字体大小。另外line_height和cell_width这类参数也可能需要根据 DPI 微调我一般会在配置里留一个dpi_scale变量根据屏幕宽度手动设成 1.0 或 1.25。6.4 快捷键冲突与失效WezTerm 的快捷键优先级高于 shell 本身如果你发现某个快捷键在 shell 里不生效很可能是被 WezTerm 拦截了。用wezterm show-keys可以查看当前所有绑定的快捷键确认有没有冲突。另外CTRLSHIFT系列的组合在 Win11 上有时会被系统输入法拦截如果发现某个键没反应先切到英文输入法试试。问题现象可能原因排查方法启动闪退配置文件语法错误用空配置启动逐段注释定位中文乱码字体不支持或编码错误加中文回退字体检查 UTF-8 设置字体大小不一致屏幕 DPI 不同用 screens() 动态计算字号快捷键失效被 WezTerm 或输入法拦截用 show-keys 查看绑定切换输入法测试主题不生效配置加载顺序错误确认 color_scheme 在 config_builder 之后设置7. 我在这套配置上积累的几个实用心得第一个心得是关于配置文件的版本管理。我现在把 WezTerm 配置放在一个私有 Git 仓库里但不会把整个目录都同步而是只同步core.lua、theme.lua和keys.lua这三个文件。shells.lua因为涉及不同机器的路径差异我选择各机器单独维护。这样既保证了视觉一致性又避免了路径问题导致的启动失败。第二个心得是关于字体渲染的。Win11 的 ClearType 在 WezTerm 里默认是关闭的如果你觉得字体边缘不够锐利可以在配置里加上config.freetype_load_target Light和config.freetype_render_target HorizontalLcd。这两个参数对 LCD 屏幕的字体渲染改善很明显但如果你用的是 OLED 屏幕建议保持默认不然可能出现彩边。第三个心得是关于主题切换的。我现在固定用 Catppuccin Mocha 这个配色原因是它的对比度适中长时间盯着不容易累而且它对各种终端工具的适配都很完善starship、eza、bat 这些工具都有对应的主题文件。如果你也在用这些工具建议把它们的配色跟 WezTerm 统一整体观感会协调很多。第四个心得是关于配置调试的。WezTerm 有一个很实用的功能是wezterm --config-file可以指定临时配置文件启动调试新配置的时候不用覆盖现有的。另外CTRLSHIFTL可以打开调试面板查看当前生效的所有配置项排查问题时非常有用。最后分享一个关于 PowerShell 7 和 WezTerm 配合的小技巧。如果你经常需要在不同项目目录之间跳转可以在 PowerShell profile 里集成zoxide然后在 WezTerm 的快捷键里绑定一个快速打开新标签页并进入指定目录的操作。我现在的用法是CTRLSHIFTN打开新标签页配合 zoxide 的z命令几秒钟就能跳到目标项目比用鼠标点来点去快得多。这套组合用下来我基本上已经回不去 Windows Terminal 了。
Win11 终端美化：WezTerm 与 PowerShell 7 配置及主题同步指南
1. 为什么要在 Win11 上折腾 WezTerm 加 PowerShell如果你跟我一样每天在 Windows 上敲命令的时间比点鼠标还多那大概率会对系统自带的 Windows Terminal 有那么点“能用但不够爽”的感觉。字体渲染偶尔发虚、分屏逻辑不够顺手、配置同步全靠手动复制 JSON换台机器就得重新来一遍。我前后试过 Tabby、Alacritty、Fluent Terminal 这些最后稳定留在 WezTerm 上核心原因就一个它是用 Rust 写的GPU 加速渲染配置文件用 Lua跨平台一套配置通吃而且主题同步这件事它能做得非常优雅。这篇内容就是把我自己在 Win11 上把 WezTerm 配成 PowerShell 默认终端、并且让主题在多设备之间自动同步的完整过程拆开讲。涉及的东西包括WezTerm 的安装与基础配置、PowerShell 7 的接入、字体与渲染调优、Lua 配置文件的模块化组织、主题同步的几种可行方案以及我在这个过程中踩过的坑。适合已经对终端有基本使用需求、想从默认终端迁移到更高效工具的人也适合已经在用 WezTerm 但配置还停留在“能用就行”阶段的朋友。先说清楚一件事WezTerm 不是那种装完就能无脑用的终端它的默认配置相当朴素甚至可以说有点丑。但它的可配置深度是同类工具里数一数二的你愿意花时间调它就能变成你每天最顺手的那个工具。下面我按实际操作的顺序来展开每一步都说明为什么这么做以及我试过哪些不太行的方案。2. 环境准备与 WezTerm 安装的细节考量2.1 Win11 下的安装方式选择WezTerm 在 Windows 上的安装方式主要有三种官网直接下载 MSI 安装包、通过 winget 安装、通过 Scoop 安装。我推荐用 winget原因是它跟 Win11 的集成度最好后续升级一条命令就搞定不用每次去官网看有没有新版本。winget install wez.wezterm装完之后你可以在开始菜单里找到 WezTerm但先别急着打开。这里有个细节WezTerm 默认会把自己注册成一个终端选项但不会自动替换掉系统默认终端。Win11 的默认终端设置藏在“设置 系统 开发者选项”或者直接搜索“默认终端应用”里你需要手动把默认终端应用改成 WezTerm。这一步不做的话你右键“在终端中打开”还是会弹出 Windows Terminal。注意如果你之前装过 Windows Terminal 的预览版默认终端设置里可能会出现多个条目认准 WezTerm 那个带图标的选择就行。2.2 PowerShell 7 的安装与版本确认系统自带的 Windows PowerShell 5.1 虽然能用但语法特性和性能都落后了。PowerShell 7 是跨平台版本基于 .NET Core启动更快对 UTF-8 的支持也更完善。安装同样走 wingetwinget install Microsoft.PowerShell装完之后在 WezTerm 里执行pwsh应该能直接进入 PowerShell 7。如果你不确定当前用的是哪个版本用$PSVersionTable看一眼就清楚了。我建议把 PowerShell 7 设为 WezTerm 的默认启动 shell而不是继续用 5.1原因后面讲配置的时候会提到。2.3 字体准备为什么 Nerd Font 是刚需WezTerm 本身对字体没什么特殊要求但如果你想让终端里的图标、Powerline 符号、Git 状态提示正常显示就必须装一个 Nerd Font。我试过不装 Nerd Font 直接用 Consolas结果 starship 提示符里的分支图标全变成方块看着非常难受。推荐用 JetBrainsMono Nerd Font 或者 CaskaydiaCove Nerd Font前者字形偏紧凑后者更接近 Windows 原生字体的观感。下载下来解压全选字体文件右键“为所有用户安装”即可。装完之后在 WezTerm 配置里指定字体名称注意名称要写对比如JetBrainsMono Nerd Font少一个空格都可能识别不到。3. WezTerm 配置文件的结构化组织3.1 配置文件放哪里、叫什么名字WezTerm 在 Windows 上读取配置文件的路径是%USERPROFILE%\.wezterm.lua也就是C:\Users\你的用户名\.wezterm.lua。这个文件默认不存在需要你自己创建。我建议不要把所有配置都堆在一个文件里而是拆成几个模块用 Lua 的require来组织。这样做的好处是主题同步的时候只需要同步主题相关的那个文件不会把整个配置都搅在一起。我的目录结构是这样的.wezterm.lua -- 入口文件负责加载其他模块 wezterm/ core.lua -- 基础设置字体、窗口、滚动 keys.lua -- 快捷键绑定 theme.lua -- 主题与配色 shells.lua -- shell 启动配置入口文件里用require加载local wezterm require(wezterm) local config wezterm.config_builder() require(wezterm.core)(config) require(wezterm.keys)(config) require(wezterm.theme)(config) require(wezterm.shells)(config) return config这里有个坑要注意require的路径是相对于 WezTerm 的配置目录的不是相对于当前文件。所以wezterm/core.lua这个写法是对的但如果你把文件放在别的地方路径就要相应调整。我一开始把模块放在.config/wezterm/下面结果一直报找不到模块后来才搞明白路径规则。3.2 基础配置里必须调的几个参数core.lua里我重点调了这几个东西。字体部分config.font wezterm.font(JetBrainsMono Nerd Font, { weight Medium }) config.font_size 11.5 config.line_height 1.15line_height这个参数很多人会忽略默认值 1.0 在高分屏上看起来行距偏紧调到 1.1 到 1.2 之间阅读舒适度会明显提升。font_size也不要盲目调大11 到 12 之间配合 Win11 的缩放比例通常比较合适。窗口和渲染部分config.window_background_opacity 0.95 config.win32_system_backdrop Acrylic config.front_end WebGpu config.max_fps 120front_end选 WebGpu 是因为它在 Win11 上的渲染效率比默认的 OpenGL 更好尤其是多标签页切换的时候掉帧更少。win32_system_backdrop设成 Acrylic 能启用 Win11 的亚克力模糊效果配合透明度看起来很有质感。但如果你用的是核显或者老显卡建议把front_end改回默认不然可能出现渲染异常。滚动缓冲我设成了 10000 行默认的 3500 行在跑编译输出或者日志的时候经常不够用config.scrollback_lines 100003.3 快捷键绑定的实用调整WezTerm 默认的快捷键跟 Windows Terminal 有不少冲突比如分屏是CtrlShiftAlt方向键按起来非常别扭。我在keys.lua里改成了更顺手的组合config.keys { { key d, mods CTRL|SHIFT, action wezterm.action.SplitHorizontal({ domain CurrentPaneDomain }) }, { key e, mods CTRL|SHIFT, action wezterm.action.SplitVertical({ domain CurrentPaneDomain }) }, { key w, mods CTRL|SHIFT, action wezterm.action.CloseCurrentPane({ confirm false }) }, { key h, mods CTRL|SHIFT, action wezterm.action.ActivatePaneDirection(Left) }, { key l, mods CTRL|SHIFT, action wezterm.action.ActivatePaneDirection(Right) }, }这套绑定逻辑跟 Vim 的方向习惯一致h往左、l往右用习惯了之后分屏切换几乎不用思考。CloseCurrentPane的confirm设成 false 是因为我经常误触每次弹确认框太烦索性关掉反正终端里也没什么不能重来的操作。4. 把 PowerShell 7 配成默认 Shell 的完整流程4.1 默认启动 Shell 的设置方法在shells.lua里指定默认程序config.default_prog { pwsh.exe, -NoLogo }-NoLogo参数能去掉 PowerShell 启动时那段版权信息让终端打开更干净。如果你想让 WezTerm 启动时直接进入某个目录可以加上-WorkingDirectory参数但我不建议写死因为不同项目目录不一样用zoxide或者Set-Location在 shell 里跳转更灵活。这里有个容易踩的坑如果你装了 PowerShell 7 但pwsh.exe不在 PATH 里WezTerm 会启动失败并直接闪退。确认方法是在 Win11 的“设置 系统 系统信息 高级系统设置 环境变量”里检查 PATH 是否包含 PowerShell 7 的安装目录通常是C:\Program Files\PowerShell\7。4.2 PowerShell 7 的 Profile 配置要点WezTerm 只负责启动 shell真正让终端好用的还是 shell 本身的配置。PowerShell 7 的 profile 文件路径可以用$PROFILE查看通常在Documents\PowerShell\Microsoft.PowerShell_profile.ps1。我在这份 profile 里做了几件事第一设置 UTF-8 编码避免中文乱码[Console]::OutputEncoding [System.Text.Encoding]::UTF8 $OutputEncoding [System.Text.Encoding]::UTF8第二引入 starship 提示符。starship 是跨 shell 的提示符工具配置一次到处能用Invoke-Expression (starship init powershell)第三设置一些常用别名和函数比如ll对应Get-ChildItem -Force..对应Set-Location ..。这些看起来是小东西但每天敲几百次命令的时候省下来的时间很可观。提示PowerShell 7 的执行策略默认可能是 Restricted导致 profile 无法加载。用Set-ExecutionPolicy -Scope CurrentUser RemoteSigned改一下就行这个操作只影响当前用户不需要管理员权限。4.3 启动速度优化别让 profile 拖慢终端PowerShell 7 的 profile 如果写得太重每次开终端都要等一两秒体验很差。我实测下来starship 初始化大概占 100 到 200 毫秒zoxide 初始化差不多但如果再加载一堆模块启动时间就会飙到一秒以上。优化思路是把不必要的东西延迟加载。比如posh-git这种模块可以只在进入 Git 仓库时才加载而不是每次启动都加载。另外Import-Module能少用就少用很多功能用原生命令或者简单的函数就能替代。我现在的 profile 加载时间稳定在 300 毫秒以内开终端基本是秒开。5. 主题同步的几种方案与实操对比5.1 为什么主题同步是个值得解决的问题我平时在两台机器上用 WezTerm一台台式机一台笔记本如果主题配置不同步每次换机器都要重新调一遍配色非常烦。主题同步的核心诉求其实就两个配色方案一致、字体和渲染参数一致。至于快捷键和 shell 配置那些可以各机器不同但视觉层面的一致性对使用体验影响很大。5.2 方案一Git 仓库同步整个配置目录最直接的办法是把整个.wezterm.lua和wezterm/目录放进一个 Git 仓库两台机器都 clone 下来改完 push另一台 pull。这个方案的好处是简单、可控、版本可追溯。坏处是如果两台机器的屏幕分辨率或者缩放比例不同字体大小这类参数可能需要分别调整每次 pull 都会覆盖掉本地修改。我的做法是在core.lua里根据屏幕尺寸动态设置字体大小local screen wezterm.gui.screens().active if screen.width 2560 then config.font_size 12.5 else config.font_size 11.0 end这样同一份配置在不同机器上都能有合适的显示效果不用手动改来改去。5.3 方案二用 Lua 模块做主题切换WezTerm 内置了不少配色方案可以用config.color_scheme直接指定。我习惯把主题相关的配置单独放在theme.lua里并且定义一个主题列表用快捷键循环切换local schemes { Catppuccin Mocha, Tokyo Night, Gruvbox Dark } local current 1 return function(config) config.color_scheme schemes[current] config.keys config.keys or {} table.insert(config.keys, { key t, mods CTRL|SHIFT, action wezterm.action_callback(function(window, pane) current current % #schemes 1 window:set_config_overrides({ color_scheme schemes[current] }) end), }) end这个方案适合喜欢经常换配色的人但要注意set_config_overrides只对当前窗口生效新开的窗口还是会用配置文件里的默认主题。如果你想让切换持久化还是得改配置文件本身。5.4 方案三用外部工具生成主题配置如果你对配色有更精细的要求比如想根据系统壁纸自动生成终端配色可以用pywal这类工具生成配色文件然后让 WezTerm 读取。具体做法是让 pywal 输出一个 Lua 文件在theme.lua里dofile加载它。这个方案的可玩性最高但配置链路也最长适合愿意折腾的人。我试过一段时间后来觉得维护成本太高就放弃了还是手动选几个顺眼的配色方案更省事。6. 常见问题与排查技巧实录6.1 终端启动闪退或报错最常见的原因是配置文件语法错误。Lua 的报错信息有时候不太直观如果 WezTerm 启动就闪退先用wezterm --config-file NUL启动一个不带配置的实例确认是配置问题还是程序本身的问题。然后逐段注释掉配置内容定位到具体哪一行出错。我遇到过一次是因为在config_builder之前就调用了config.font顺序错了导致整个配置加载失败。6.2 中文显示乱码或宽度异常这个问题通常有两个原因字体不支持中文或者编码设置不对。字体方面Nerd Font 本身对中文的支持有限建议在font配置里加一个中文回退字体config.font wezterm.font_with_fallback({ JetBrainsMono Nerd Font, Microsoft YaHei, })编码方面确保 PowerShell 7 的 profile 里设置了 UTF-8同时 WezTerm 的default_prog不需要额外加编码参数它默认就是 UTF-8。6.3 主题同步后字体渲染不一致两台机器如果缩放比例不同同样的font_size看起来大小会不一样。解决办法是用wezterm.gui.screens()获取当前屏幕的 DPI 信息动态计算字体大小。另外line_height和cell_width这类参数也可能需要根据 DPI 微调我一般会在配置里留一个dpi_scale变量根据屏幕宽度手动设成 1.0 或 1.25。6.4 快捷键冲突与失效WezTerm 的快捷键优先级高于 shell 本身如果你发现某个快捷键在 shell 里不生效很可能是被 WezTerm 拦截了。用wezterm show-keys可以查看当前所有绑定的快捷键确认有没有冲突。另外CTRLSHIFT系列的组合在 Win11 上有时会被系统输入法拦截如果发现某个键没反应先切到英文输入法试试。问题现象可能原因排查方法启动闪退配置文件语法错误用空配置启动逐段注释定位中文乱码字体不支持或编码错误加中文回退字体检查 UTF-8 设置字体大小不一致屏幕 DPI 不同用 screens() 动态计算字号快捷键失效被 WezTerm 或输入法拦截用 show-keys 查看绑定切换输入法测试主题不生效配置加载顺序错误确认 color_scheme 在 config_builder 之后设置7. 我在这套配置上积累的几个实用心得第一个心得是关于配置文件的版本管理。我现在把 WezTerm 配置放在一个私有 Git 仓库里但不会把整个目录都同步而是只同步core.lua、theme.lua和keys.lua这三个文件。shells.lua因为涉及不同机器的路径差异我选择各机器单独维护。这样既保证了视觉一致性又避免了路径问题导致的启动失败。第二个心得是关于字体渲染的。Win11 的 ClearType 在 WezTerm 里默认是关闭的如果你觉得字体边缘不够锐利可以在配置里加上config.freetype_load_target Light和config.freetype_render_target HorizontalLcd。这两个参数对 LCD 屏幕的字体渲染改善很明显但如果你用的是 OLED 屏幕建议保持默认不然可能出现彩边。第三个心得是关于主题切换的。我现在固定用 Catppuccin Mocha 这个配色原因是它的对比度适中长时间盯着不容易累而且它对各种终端工具的适配都很完善starship、eza、bat 这些工具都有对应的主题文件。如果你也在用这些工具建议把它们的配色跟 WezTerm 统一整体观感会协调很多。第四个心得是关于配置调试的。WezTerm 有一个很实用的功能是wezterm --config-file可以指定临时配置文件启动调试新配置的时候不用覆盖现有的。另外CTRLSHIFTL可以打开调试面板查看当前生效的所有配置项排查问题时非常有用。最后分享一个关于 PowerShell 7 和 WezTerm 配合的小技巧。如果你经常需要在不同项目目录之间跳转可以在 PowerShell profile 里集成zoxide然后在 WezTerm 的快捷键里绑定一个快速打开新标签页并进入指定目录的操作。我现在的用法是CTRLSHIFTN打开新标签页配合 zoxide 的z命令几秒钟就能跳到目标项目比用鼠标点来点去快得多。这套组合用下来我基本上已经回不去 Windows Terminal 了。
