GitHub - microsoft/terminal: The new Windows Terminal and the original Windows console host, all in the same place!
微软官方开源的 Windows Terminal 与 Windows 控制台宿主(conhost.exe)源码仓库。Windows Terminal 是一个新式、功能丰富、高效的终端应用,支持标签页、富文本、全球化、配置化、主题样式等功能;同时仓库也包含经典 Windows 控制台宿主与现代控制台基础设施的共享组件(如 DirectWrite 文本渲染引擎、UTF-8/UTF-16 文本缓冲区、VT 解析器、ConPTY 等)。项目的设计目标是在保持兼容性的同时,为命令行用户提供现代化体验。
社区作者 · zZz
它解决什么问题
该仓库包含 Windows Terminal、Windows Terminal Preview、Windows 控制台宿主(conhost.exe)以及两者共享组件的完整源代码。Windows Terminal 是微软推出的现代终端应用程序,支持多标签页、富文本、个性化主题、自定义配置、全球化语言等特性,并集成了对 PowerShell、CMD、WSL、SSH 等命令行环境的支持。经典控制台宿主 conhost.
exe 的源代码也保留在此仓库中,其主要目标在于向后兼容,同时团队于 2014 年起为其增加了背景透明、行选择、ANSI/VT 序列、24 位颜色、Pseudoconsole(ConPTY)等功能。共享部分包括 DirectWrite 文本布局与渲染引擎、支持 UTF-16 和 UTF-8 的文本缓冲区、VT 解析器/发射器、WIL(Windows Implementation Libraries)等新代码。项目以 C++ 开发,可复用于任何 Windows 终端实现。
仓库还包含 ColorTool 工具和演示 Windows 控制台 API 用法的示例项目。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
注意:Windows Terminal 需要 Windows 10 2004(build 19041)或更高版本。
一、Microsoft Store 安装(推荐) 从 Microsoft Store 安装 Windows Terminal,该方式会自动升级到最新版本。
二、其他安装方式
Add-AppxPackage Microsoft.WindowsTerminal_<版本号>.msixbundle (如果使用 PowerShell 7+,请先执行 Import-Module Appx -UseWindowsPowerShell) 注意:手动安装可能需要额外安装 VC++ v14 Desktop Framework Package(旧版 Windows 10);手动安装不会自动更新,需要定期下载最新版本。
- 通过 GitHub:无法使用 Microsoft Store 的用户,可在本仓库 Releases 页面下载 Assets 中的 Microsoft.WindowsTerminal_<版本号>.msixbundle 文件。双击该文件即可自动安装;若失败,可在 PowerShell 中运行:
- 通过 winget:
winget install --id Microsoft.WindowsTerminal -e(若安装 1.18 及以上稳定版,需要 WinGet 1.6.2631 或更高版本)
- 通过 Chocolatey(非官方):
choco install microsoft-windows-terminal升级
choco upgrade microsoft-windows-terminal步骤 4 · 通过
Scoop(非官方):
scoop bucket add extrasscoop install windows-terminal更新
scoop update windows-terminal三、安装 Windows Terminal Canary Canary 是每夜构建版,提供主分支最新代码,稳定性最低。提供 App Installer 分发(仅 Windows 11,支持自动更新)和便携式 ZIP 分发(Windows 10 19041+ 与 Windows 11,不自动更新)。可通过页面表格下载 x64、ARM64、x86 架构对应的 App Installer 或 Portable ZIP。
四、从源码构建(开发者) 前提条件:
- 运行 Windows 10 2004(build 10.0.19041.0)或更高版本;
- 在 Windows 设置中启用“开发人员模式”;
- 安装 PowerShell 7 或更高版本;
- 安装 Windows 11 SDK(版本 10.0.26100.8249 或更高);
- 安装 Visual Studio 2026(至少 18.6 版),并安装以下工作负载:“使用 C++ 的桌面开发”和“WinUI 应用程序开发”;
- 安装 .NET Framework 4.7.2 目标包(用于构建测试项目)。
也可使用 WinGet 配置文件自动安装环境:
winget configure .config\configuration.winget构建步骤(PowerShell): Import-Module .\tools\OpenConsole.psm1 Set-MsBuildDevEnvironment Invoke-OpenConsoleBuild
构建步骤(Cmd): .tools\razzle.cmd bcz
运行与调试:在 Visual Studio 中右键点击 CascadiaPackage 项目,在调试属性中将“Application process”和“Background task process”改为“Native Only”,选择 x64 或 x86 平台后按 F5 部署调试。注意:不要直接运行 WindowsTerminal.exe 来启动终端。