WezTerm Windows 安装全指南安装器、便携版与 winget/Scoop/Chocolatey 实践【免费下载链接】weztermA GPU-accelerated cross-platform terminal emulator and multiplexer written by wez and implemented in Rust项目地址: https://gitcode.com/GitHub_Trending/we/wezterm本文是 WezTerm 在 Windows 平台上的完整安装与上手指南覆盖官方setup.exe安装器、免安装 zip 便携版以及winget、Scoop、Chocolatey三种主流命令行包管理器的安装与升级方法。读完本文你不仅能根据自身场景图形向导、静默脚本、U 盘便携、命令行托管选择最合适的安装方式还能理解 WezTerm 对 Windows 版本要求背后的 ConPTY 技术原因以及安装完成后的配置文件放置与验证方法。Windows 版本要求为什么必须是 10.0.17763 及以上WezTerm 官方要求64 位 Windows 10.0.17763 或更高版本即 Windows 10 1809 及之后的 64 位系统在此之前的 Windows 版本上无法运行。这一硬性门槛并非人为限制而是由终端的技术基础决定的WezTerm 在 Windows 上依赖 Windows Pseudo ConsoleConPTY 中可以看到同样的约束被写死在安装器层面; Build 1809 is required for pty support MinVersion10.0.17763 ArchitecturesAllowedx64 arm64 ArchitecturesInstallIn64BitModex64 arm64即安装器只允许在 x64 与 arm64 架构、且版本不低于 1809 的系统上安装低于该版本时安装向导会直接拒绝。一个值得注意的细节是由于 Windows 自带的 ConPTY 实现曾缺少鼠标报告支持仓库在 assets/windows/conhost/ 中附带了一份从 Microsoft Terminal 项目MIT 许可构建的OpenConsole.exe用于在 Windows 上启用完整的鼠标事件上报能力。这也是为什么安装包中除了核心程序之外还会带上OpenConsole.exe与conpty.dll等运行时文件。在 pty/src/win/mod.rs 中可以看到 Windows 平台 Pty 层的实现确实围绕conpty模块展开并基于CreatePseudoConsole系列 API 完成伪终端创建。方式一setup.exe 图形安装器官方推荐WezTerm 官方提供setup.exe风格的安装器它由 Inno Setup 制作特点如下安装位置默认安装到 Program Files 目录脚本中为DefaultDirName{autopf}\WezTermPATH 注册安装器会将该安装目录写入系统 PATH 环境变量安装后可直接在任意命令行中调用wezterm、wezterm-gui等命令权限要求运行安装器需要管理员权限卸载支持通过控制面板 / 设置 → 应用即可卸载卸载时安装器也会自动从 PATH 中移除对应条目。除了图形向导安装器还完整支持 Inno Setup 标准命令行选项可用于自动化与脚本化部署。例如常见的静默安装参数组合$ setup.exe /VERYSILENT /SUPPRESSMSGBOXES /NORESTART其中/VERYSILENT表示全程静默不显示界面/SUPPRESSMSGBOXES抑制确认弹窗/NORESTART禁止安装后重启。此外还可通过/DIR...自定义安装目录、/TASKS...控制附加任务如是否创建桌面图标。官方发行版对应的夜间构建Nightly同样提供 setup.exe 安装包。从 ci/windows-installer.iss 的脚本可以看出安装器实际打包的组件清单与target\release产物对应wezterm.exe、wezterm-gui.exe、wezterm-mux-server.exe三个主程序mesa\opengl32.dll、libEGL.dll、libGLESv2.dll等 GPU/OpenGL 渲染依赖对应 assets/windows/mesa/conpty.dll与OpenConsole.exe这两个 ConPTY 运行时组件对应 assets/windows/conhost/strip-ansi-escapes.exe辅助工具。安装器还会在注册表中注册右键菜单入口 Open WezTerm here为驱动器、目录背景和目录添加上下文菜单命令其实现为调用wezterm-gui.exe start --no-auto-connect --cwd %V见脚本的[Registry]段。方式二zip 便携版免安装、可随身携带如果你不希望以管理员身份安装软件或者需要在多台机器之间迁移可以选择 zip 压缩包下载 Windows zip 发行包Release 或 Nightly解压 zip 文件双击其中的wezterm.exe即可启动图形界面配置文件说明见 docs/config/files.md。zip 版可以从任意目录运行包括 U 盘等可移动介质实现真正意义上的便携portable/relocatable安装全程无需任何特殊权限。便携模式还有一个贴心的配套机制为了让 U 盘用户程序与配置一起带走WezTerm 在 Windows 上会额外检查与wezterm.exe同目录下是否存在wezterm.lua若存在则优先加载该配置官方称之为 thumb drive mode即U 盘模式。这一点在 docs/config/files.md 的配置查找流程图中被明确标注。需要提醒的是如果你不是在使用 U 盘便携安装官方并不建议把配置文件放在程序目录下常规做法是放到用户目录。便携版解压后也可以把解压目录手动加入PATH即可在命令行中直接使用wezterm系列命令。方式三wingetWindows 包管理器winget随 Windows 的 App Installer 一起提供可在 Microsoft Store 获取。安装后即可使用 WezTerm 官方发布的清单仓库通过 ci/make-winget-pr.sh 自动向 winget 仓库提交新版本清单其中PackageIdentifier为wez.wezterm。安装$ winget install wez.wezterm升级$ winget upgrade wez.weztermwinget 清单声明了InstallerType: inno、MinimumOSVersion: 10.0.17763.0安装器会通过ProductCode{BCF6F0DA-5B9A-408D-8562-F680AE6E1EAF}_is1识别与升级既有安装因此你可以放心用winget upgrade反复升级而不会产生多个残留版本。方式四Scoop如果你使用 Scoop 管理软件WezTerm 位于官方 Extras bucket 中。首次使用时先添加该 bucket再安装$ scoop bucket add extras $ scoop install weztermScoop 默认以非管理员身份把软件安装到用户目录这与 WezTerm 的 zip 便携式分发精神一致后续升级使用$ scoop update wezterm方式五ChocolateyChocolatey 用户可以从其 Community Repository 安装$ choco install wezterm -y其中-y表示自动确认跳过交互提示。升级则使用$ choco upgrade wezterm安装完成后的第一步放置配置文件安装完成后WezTerm 会按固定优先级查找 Lua 配置文件。官方推荐的做法是在用户主目录放置%USERPROFILE%\.wezterm.lua对应 Unix 系的$HOME/.wezterm.lua。一个可以直接使用的入门配置-- 引入 wezterm API local wezterm require wezterm -- 持有配置对象 local config wezterm.config_builder() -- 应用你的配置选择例如设置新窗口的初始几何尺寸 config.initial_cols 120 config.initial_rows 28 -- 或者调整字号与配色方案 config.font_size 10 config.color_scheme AdventureTime -- 最后将配置返回给 wezterm return config配置文件的完整查找顺序、热重载机制修改配置后自动生效也可用CTRLSHIFTR强制重载、wezterm --config keyvalue命令行覆盖等能力详见 docs/config/files.md 与 Lua 配置参考。若你想从源码自行构建 Windows 版本需要安装 MSVC 工具链的 Rust并确保 Strawberry Perl 的perl.exe在 PATH 中可参考 docs/install/source.md。总结各安装方式速查表方式命令 / 操作是否需要管理员权限适用场景setup.exe 安装器双击向导或setup.exe /VERYSILENT静默安装需要常规桌面安装、企业脚本化部署zip 便携版解压后双击wezterm.exe不需要U 盘便携、多机迁移、免安装wingetwinget install wez.wezterm视系统策略而定已在用 winget 管理软件的用户Scoopscoop bucket add extras scoop install wezterm不需要默认装到用户目录命令行重度用户Chocolateychoco install wezterm -y通常需要企业 / 系统管理员批量管理所有方式安装后得到的都是同一份基于 Rust 实现、GPU 加速的终端仿真器与多路复用器multiplexer安装路径的差异不影响后续配置方式统一从%USERPROFILE%\.wezterm.lua开始你的 WezTerm 定制之旅。【免费下载链接】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），仅供参考