这份指南将带你从零开始，把 WezTerm 配置成一个既美观又实用的 Windows 生产力工具。
一、安装 WezTerm
https://wezterm.org/index.html
二、安装必备字体
为了确保终端内的图标和文字显示正常，建议安装 JetBrains Mono Nerd Font。
- 前往 Nerd Fonts 官网。
- 找到 JetBrainsMono Nerd Font，点击 Download。
- 解压下载的压缩包，全选所有的
.ttf文件，右键选择 “安装”（或“为所有用户安装”）。
三、安装 PowerShell 7
winget install --id Microsoft.Powershell --source winget
- 极快，启动速度和处理速度大幅提升
- 更好的错误提示
- PowerShell 5.1 默认使用
UTF-16或各种本地编码（如 GBK），这在运行像 Claude Code 这样基于 Node.js 的工具时，经常会导致乱码或奇怪的报错。PowerShell 7 默认原生支持 UTF-8，能完美显示各种图标和特殊符号。
四、配置 WezTerm
WezTerm 的所有设置都在一个 Lua 脚本中完成。
- 打开你的 文件资源管理器。
- 进入你的用户根目录（快捷路径：
%USERPROFILE%）。 - 在该目录下新建一个文件，命名为
.wezterm.lua（注意前面有个点）。 - 用记事本或 VS Code 打开它，粘贴以下配置：
local wezterm = require 'wezterm'
local config = wezterm.config_builder()
-- Shell
config.default_prog = { 'pwsh.exe', '-NoLogo' }
-- 外观
config.color_scheme = 'Dracula'
config.font = wezterm.font 'JetBrainsMono Nerd Font'
config.font_size = 10
config.default_cursor_style = 'BlinkingBar'
-- 渲染优化
config.front_end = "WebGpu"
-- scrollback
config.scrollback_lines = 10000
-- 键盘绑定
config.keys = {
-- 复制粘贴
{ key = 'v', mods = 'CTRL', action = wezterm.action.PasteFrom 'Clipboard' },
{ key = 'c', mods = 'CTRL', action = wezterm.action.CopyTo 'Clipboard' },
-- CTRL+\ 左右分屏
{ key = '\\', mods = 'CTRL', action = wezterm.action.SplitHorizontal { domain = 'CurrentPaneDomain' } },
-- CTRL+Shift+\ 上下分屏
{ key = '|', mods = 'CTRL|SHIFT', action = wezterm.action.SplitVertical { domain = 'CurrentPaneDomain' } },
-- Ctrl+D 关闭当前 pane/tab
{ key = 'd', mods = 'CTRL', action = wezterm.action.CloseCurrentPane { confirm = true } },
-- Pane 导航（Alt+方向键）
{ key = 'LeftArrow', mods = 'ALT', action = wezterm.action.ActivatePaneDirection('Left') },
{ key = 'RightArrow', mods = 'ALT', action = wezterm.action.ActivatePaneDirection('Right') },
{ key = 'UpArrow', mods = 'ALT', action = wezterm.action.ActivatePaneDirection('Up') },
{ key = 'DownArrow', mods = 'ALT', action = wezterm.action.ActivatePaneDirection('Down') },
-- 字体大小调整
{ key = '-', mods = 'CTRL', action = wezterm.action.DecreaseFontSize },
{ key = '=', mods = 'CTRL', action = wezterm.action.IncreaseFontSize },
{ key = '0', mods = 'CTRL', action = wezterm.action.ResetFontSize },
}
return config
五、安装 Starship
winget install starship
将 Starship 注入 PowerShell 7
修改 PowerShell 7 的配置文件，让它每次启动都加载 Starship。
操作步骤
- 创建并打开配置文件
if (!(Test-Path -Path $PROFILE)) { New-Item -ItemType File -Path $PROFILE -Force }
notepad $PROFILE
- 添加以下内容
# 初始化 starship
Invoke-Expression (&starship init powershell)
# 配置 alias
function cc { claude --dangerously-skip-permissions $args }
function cc { claude --dangerously-skip-permissions --model haiku $args }
function c { code $args }
- 保存并关闭记事本
- 重启 WezTerm 生效。