WezTerm
WezTerm 是用 Rust 编写的 GPU 加速跨平台终端模拟器和多路复用器，支持标签、窗格、工作区、SSH 域、图形与超链接协议、字体与配色，并以 Lua 脚本配置界面和行为。
适合做什么
WezTerm 适合需要 GPU 渲染、标签分屏、工作区、多路复用、SSH 和高度可编程键位的终端用户，也适合在 Windows、macOS 与 Linux 间共享一套主要配置。它不是 shell、容器或权限沙箱，Lua 配置比普通选项文件更强大，也带来执行未知代码和重复副作用的风险。
当前版本与平台
20240203-110809-5046fc22 于 2024-02-03 发布，至今仍是最新正式稳定版。Windows 提供 EXE 与便携 ZIP并要求 64 位 Windows 10 构建 17763 以上；macOS 提供 Intel/Apple Silicon 通用 ZIP；Linux 有 AppImage、DEB、RPM、Flatpak 和发行版包。仓库持续活跃且 nightly 更新频繁，但不少新发行版已只提供 nightly 官方构建。
配置、更新与隐私边界
wezterm.lua 是可执行 Lua 脚本，会自动重载并可能调用子进程，导入前必须审查。官方构建不上传使用数据，但默认连接 GitHub 检查更新；滚屏、SSH 会话、剪贴板和子进程处理的数据仍属于本机及远端安全边界，第三方重新打包版本也不受官方隐私承诺覆盖。
维护记录
本页依据 WezTerm 稳定发布、各平台安装文档、Lua 配置说明、隐私政策、仓库活跃状态和 MIT/OFL 许可复核，检查日期为 2026-08-06。
选择下载方式
下载前请核对资源版本和授权范围。本站不提供破解软件及未经授权的资料。
WezTerm 稳定版安装、标签分屏与 Lua 配置教程
先安装与平台匹配的稳定包并用默认配置验证 shell、字体和图形驱动，再建立最小 wezterm.lua；确认自动重载无副作用后，逐步加入键位、工作区、SSH 或多路复用设置。
安装前准备
- Windows 至少为 64 位 Windows 10 1809/构建 17763；macOS 稳定包是支持 Intel 与 Apple Silicon 的通用构建；Linux 按发行版和架构选择原生包或 AppImage。
- 备份现有 `.wezterm.lua`、XDG 配置目录和自定义模块，记录默认 shell 与启动参数；配置文件可能执行代码，未知来源必须先审查。
- 确认 GPU 驱动、等宽字体和目标 shell正常；SSH 使用可信主机密钥与最小权限账户，不在配置中明文写入口令和长期令牌。
安装步骤
- 01
选择稳定包或隔离测试 nightly
Windows 可用需要管理员权限的 EXE 或免安装 ZIP，macOS 解压应用 ZIP，Linux 优先用发行版原生包；只有确需新平台修复时才在独立目录测试 nightly。
- 02
以默认配置启动
暂时移走旧配置，确认窗口、字体、中文、复制粘贴和本地 shell 都正常；Linux Flatpak 受沙箱影响，进程目录检测与 CLI 首次启动行为可能不同于原生包。
- 03
建立最小 Lua 配置
在用户目录创建 `.wezterm.lua`，只设置字体、字号和配色，保存后观察自动重载；配置出错时使用内置默认值并查看错误信息，不要循环重启。
快速上手
- 01
组织标签、窗格与工作区
为不同项目建立工作区，用窗格同时观察日志和执行命令；给生产与测试会话使用明显标题和配色，分屏不会隔离权限。
- 02
配置快捷键与启动菜单
逐项添加常用 shell、WSL 或项目目录，避免在启动命令中保存密钥；检查快捷键与桌面、输入法、tmux 或编辑器是否冲突。
- 03
谨慎启用 SSH 与多路复用
首次连接核验主机密钥和代理路径，先使用普通测试账户；多路复用域、远端命令和自动恢复会话都应确认断线、关闭与凭据生命周期。
使用建议
- 官方隐私说明称项目 CI 构建不会发送设备或使用数据，但默认每 24 小时向 GitHub Release API 检查更新；第三方构建不受该承诺保证。
- 配置会在启动和重载时多次执行，不要在主流程无条件启动后台程序，否则可能累积大量重复进程。
- 稳定版包较旧，Ubuntu 24、Fedora 40+ 等官方页面主要提供 nightly；关键环境要在稳定性、系统兼容和修复及时性之间明确取舍。
- 终端滚屏包含命令输出、令牌和日志，虽当前保存在进程内存，截图、复制、日志工具和子进程仍可能泄露内容。
故障排查与卸载方法
启动后黑屏、渲染异常或中文缺字怎么办？
更新 GPU 驱动，先移走配置并恢复默认字体，确认所选字体包含中文；再关闭背景、图像、透明和复杂渲染设置，逐项恢复定位问题。
修改 wezterm.lua 后不断启动进程或反复报错怎么办？
立即移走配置让程序回到默认值，检查顶层代码和自定义模块是否有副作用；把启动进程操作改为明确事件或手动动作，再用配置重载逐步验证。
- 保存并审查配置备份 Lua 配置、配色和工作区说明，删除明文主机信息、令牌与私钥参数；确认终端中的重要未保存会话已经结束或转存。
- 移除软件包与可选数据卸载安装包或删除便携/应用目录，按需保留配置；shell、WSL、SSH 密钥和字体可能被其他终端共用，不要一并删除。
常见问题
为什么 WezTerm 稳定版版本号仍是 20240203？
20240203-110809-5046fc22 是当前最新正式稳定发布，发布时间为 2024-02-03。项目仓库仍持续更新，并长期提供 nightly 构建；nightly 包含新平台支持和修复，但变化频繁，不能当成稳定版直接替换关键终端环境。
WezTerm 是 shell 或 SSH 服务端吗？
不是。它提供终端模拟、多路复用和 SSH 客户端能力，本地命令仍由 PowerShell、WSL、Bash、Zsh 等 shell 执行，远端权限由 SSH 账户和服务器决定。它不会自动安装 shell，也不会把会话变成权限沙箱。
复制别人的 wezterm.lua 是否安全？
不能默认安全。配置文件是真正的 Lua 脚本，可调用运行子进程等 API，并会在启动或自动重载时被多次求值。只复制理解过的片段，不要运行含下载、凭据读取、后台进程或不明模块的配置。
下载时需要提取码吗？
夸克网盘无需提取码；百度网盘所需的四位提取码会直接显示在下载入口旁。