如果你希望在 Windows / macOS / Linux 上获得一致的终端体验，同时又想要更强的中文与字体渲染、更顺手的快捷键、更好用的标签页/窗格管理，WezTerm 是一个非常值得尝试的选择：它跨平台、性能好、可配置性强，并且用一个 wezterm.lua 就能把大部分习惯同步到多台设备。
在日常开发与效率场景里，终端通常会遇到这些痛点：同一套快捷键在不同系统不一致、字体与中文显示不稳定、复制粘贴与选择逻辑别扭、窗口分屏管理麻烦、配置散落难以迁移。WezTerm 通过统一的配置文件与强大的窗口/窗格能力，把这些问题集中解决。
Windows：推荐用 winget 安装，升级也方便；也可以从官网下载安装包。
winget install wez.weztermmacOS：推荐 Homebrew 安装；也可以下载 dmg。
brew install --cask weztermLinux：不同发行版包管理器不同。若你不确定，优先参考官方安装页，避免使用来源不明的第三方包。
（1）确认默认 shell 与编码正常：打开后输入一段中文、表情符号或常用符号，看看是否出现乱码或方块。
（2）找对配置文件位置：WezTerm 的核心配置是 wezterm.lua。常见位置：
Windows：%USERPROFILE%\.config\wezterm\wezterm.lua
macOS/Linux：~/.config/wezterm/wezterm.lua
下面这份配置覆盖了：字体、字号、配色主题、Tab 样式、复制粘贴与常用快捷键。你可以先照抄，再逐步调整。
local wezterm = require 'wezterm' return { -- 字体与字号：优先选择你系统里真实存在的字体 font = wezterm.font_with_fallback({ 'JetBrainsMono Nerd Font', 'FiraCode Nerd Font', 'Sarasa Mono SC', 'Microsoft YaHei', }), font_size = 13.0, -- 主题：可先用内置主题名，后续再挑 color_scheme = 'Builtin Solarized Dark', -- 终端行为 enable_tab_bar = true, hide_tab_bar_if_only_one_tab = true, window_decorations = 'RESIZE', use_fancy_tab_bar = false, -- 更顺手的复制/粘贴（配合鼠标选择） -- 说明：不同系统对 Ctrl/Command 行为不同，按需改 keys = { { key = 'c', mods = 'CTRL|SHIFT', action = wezterm.action.CopyTo 'Clipboard' }, { key = 'v', mods = 'CTRL|SHIFT', action = wezterm.action.PasteFrom 'Clipboard' }, { key = 'Enter', mods = 'ALT', action = wezterm.action.ToggleFullScreen }, }, }坑 A：中文变窄/间距怪。通常是 fallback 字体选择不当导致。建议把你常用的中文等宽字体（例如 Sarasa Mono SC）放到 fallback 列表里，并确保系统已正确安装。
坑 B：图标/符号显示成方块。多半是 Nerd Font 不完整或未安装。优先安装 JetBrainsMono Nerd Font / FiraCode Nerd Font 这一类带图标补全的字体。
挑主题时建议先用 3 个标准自测：注释是否清晰、错误提示是否足够醒目、选中高亮是否容易看清。然后再决定是否追求更“炫”的配色。
WezTerm 的强项之一是窗格（pane）与标签页（tab）管理。你可以把同一项目的：构建、日志、REPL、Git 操作分在不同窗格，减少来回切换窗口的成本。
如果你希望更强的“项目级会话”，可以把常用命令做成启动脚本或在 shell 里写 alias（注意：alias 属于 shell 配置，不是 WezTerm 本身）。
推荐做法是把 ~/.config/wezterm（或 Windows 对应目录）放进你的个人配置仓库（私有 Git 仓库/加密同步盘都可以）。同步时记住两点：
（1）不要把敏感信息写进配置（比如私钥路径、内网地址、公司机密命令）。
（2）用 font_with_fallback 兼容不同系统字体差异，避免换机后启动报错。
启动后黑屏/闪退：优先检查配置语法是否有误（比如漏了逗号/引号）。可以先把 wezterm.lua 暂时改成最小配置，确认能启动再逐段加回。
快捷键无效：确认是 WezTerm 接管还是被系统快捷键抢占（macOS 上 Command 相关键更容易冲突）。必要时换一组组合键。
粘贴出现奇怪的换行：有些 shell/工具会在粘贴时做处理，建议在 WezTerm 与 shell 两侧分别排查，先用纯文本粘贴验证。
终端不是越复杂越好，而是越贴合你的习惯越好。建议你先用本文的基础配置跑起来，稳定后再逐步加入更个性化的快捷键、工作区与启动逻辑。只要 配置可迁移，你就不会在换电脑/重装系统时从零开始。
