Windows Terminal 版本更新实战指南：5 条渠道任选，附升级回滚排查清单

Windows Terminal 版本更新实战指南：5 条渠道任选，附升级回滚排查清单

【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal

Windows Terminal 是微软开源的现代终端应用，支持标签页、多窗格与完整配色主题，但"装了三个版本、升级后配置丢了、回滚不知从何下手"是不少用户的真实经历。读完本文，你能分清 Stable、Preview、Canary 三档版本的更新节奏，掌握从 Microsoft Store 到命令行包管理器共 5 条安装渠道的操作命令，并拿到一套升级失败时的排查与回滚清单，最后按你的使用人群直接对号入座。

一、先分清三档版本的定位：Canary、Preview、Stable 到底差在哪

这一步解决"我该跟哪个版本"的问题。项目遵循固定的特性流入顺序：新特性先出现在每日构建的 Canary 里，打磨稳定后进入 Preview（预览版），通常再过一个发布周期才合入 Stable（稳定版）。官方发布节奏大致为每季度一个里程碑，详见 doc/roadmap-2023.md。

图 1：Windows Terminal 窗口示意，标签页与多窗格是它区别于经典控制台的核心能力

二、首选渠道：Microsoft Store 安装与自动升级

本节回答"零维护成本地保持最新版怎么做"。官方推荐 Store 渠道，因为升级由系统静默完成，无需你记住任何命令。前提是 Windows 10 2004（19041）或更高版本，这一点来自 README.md 的明确说明。

在 Microsoft Store 完成安装

• 操作目标：装好稳定版并让系统接管后续升级
• 核心操作：打开 Microsoft Store，搜索 Windows Terminal 并点击安装
• 效果验证：启动应用后，新建标签页执行wt --version，输出的四位版本号即当前安装版本

技巧：Store 版升级时不会杀掉你正在运行的会话，可以放心开着干活等升级。

手动检查一次更新

• 操作目标：确认 Store 已把应用升到最新
• 核心操作：Store 中搜索 Windows Terminal → 应用详情页点击"获取"或"更新"按钮
• 效果验证：再次执行wt --version，对照官方发布记录确认版本前进

三、命令行渠道：用 winget 或 Chocolatey 三步装好终端

适合习惯脚本化的开发者。这条线的好处是可以把安装动作写进入职脚本或还原镜像，命令全部取自项目 README 的官方说明。

用 winget 安装与升级

• 操作目标：通过 Windows 包管理器（winget，Windows 内置的命令行装包工具）拿最新稳定版
• 核心命令：

winget install --id Microsoft.WindowsTerminal -e

• 效果验证：winget version确认客户端版本不低于 1.6.2631（README 要求的新版才有依赖支持）；随后wt --version查看终端版本

用 Chocolatey 作为替代

• 操作目标：已用 Chocolatey 管软件的用户走同一条习惯路径
• 核心命令：

choco install microsoft-windows-terminal choco upgrade microsoft-windows-terminal

• 效果验证：同样以wt --version的输出版本号为准

技巧：Chocolatey 版属于社区维护的"非官方"渠道，遇装包问题按 README 指引去对应渠道反馈。

四、手动渠道：下载 msixbundle 安装包精确控版本

这一节面向"必须锁死版本号"的场景，比如内网机器、合规要求固定的企业环境。做法是从仓库发布页下载Microsoft.WindowsTerminal_<版本号>.msixbundle（msixbundle 是 Windows 应用的分发封装格式，类似一个安装包），安装方式有二：

双击或命令安装离线包

• 操作目标：把指定版本装进系统
• 核心命令（双击安装包无效时使用）：

Add-AppxPackage Microsoft.WindowsTerminal_<版本号>.msixbundle

• 效果验证：开始菜单能搜到应用，wt --version输出与安装包文件名中的版本号一致

⚠️ 手动安装的应用不会自动升级，之后每个新版本都要重复本节的下载与安装动作；老版本 Windows 10 上还可能需要补装 VC++ 运行时框架，否则启动报缺框架错误。

五、尝鲜渠道：Canary 每日构建的两种拿法

本节面向想第一时间摸新特性、或愿意给社区报 Bug 的开发者。Canary 是 main 分支的每日构建，官方定位就是"最不稳定的一档"，请接受它可能随时坏掉。它提供两种分发形态，各有适用面：

装 Portable ZIP 版 Canary

• 操作目标：在正式环境之外开一个每日更新的"试验田"
• 核心操作：下载对应架构（x64 / ARM64 / x86）的 ZIP 包，解压后直接运行其中的 exe
• 效果验证：运行wt --version，版本号带日期段，确认与当日构建对应

图 2：多窗格（Pane）布局演示，这类功能常率先在 Canary/Preview 档出现

六、升级避坑清单：备份 settings.json、排查故障与版本回滚

这一节集中处理"升级可能弄丢什么、弄坏了怎么救"。终端的全部个性化配置集中在settings.json里，它是升级前唯一必须备份的文件；它位于你当前安装包对应的包数据目录下，形如$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json。

升级前先备份配置文件

• 操作目标：把 settings.json 复制到仓库之外
• 核心命令：

Copy-Item "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json" -Destination "$env:USERPROFILE\Documents\wt-settings.json"

• 效果验证：目标路径下能看到复制出的 settings.json

升级失败排查清单

按顺序尝试，通常前两步就能解决：

Get-AppxPackage -Name Microsoft.WindowsTerminal Reset-AppxPackage Add-AppxPackage -Register "$env:LOCALAPPDATA\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\AppxManifest.xml"

第一行查包状态，第二行重置应用数据，第三行重新注册应用包。三步之后重启终端再验证。

回滚到旧版本

• 操作目标：新版本不兼容时，降级回手上已有的旧安装包
• 核心命令：

Add-AppxPackage -Path .\旧版本的msixbundle -ForceApplicationShutdown

• 效果验证：重启后wt --version回到旧版本号

技巧：给不同版本的安装包按版本号建独立目录归档，回滚时按文件名直接取用，比临时去下载页翻找快得多。

七、按人群快速决策：一张表选对渠道

本节不再展开原理，直接给结论。对照你的日常角色取一行即可：

参考文章风格说明已删除，以下为术语速查。

术语速查：Preview（预览版）——新特性流入的稳定版前哨；Canary——main 分支的每日构建，最新最不稳；msixbundle——Windows 应用安装包封装格式；winget——Windows 内置命令行包管理器；settings.json——终端全部用户配置所在的 JSON 文件。

延伸资源

• 安装入口与完整渠道说明：README.md
• 发布节奏与版本规划：doc/roadmap-2023.md、doc/roadmap-2022.md
• JSON 配置说明：doc/user-docs/UsingJsonSettings.md
• 问题追踪：项目仓库的 Issues 区（提交前先搜相似问题，README 有明确要求）

【免费下载链接】terminalThe new Windows Terminal and the original Windows console host, all in the same place!项目地址: https://gitcode.com/GitHub_Trending/term/terminal