企业官网建设流程全解析

欢迎来到 Windows Terminal、控制台和命令行仓库

本仓库包含以下项目的源代码：Windows Terminal、Windows Terminal 预览版、Windows 控制台主机（conhost.exe）、两个项目共享的组件、ColorTool、展示如何使用 Windows 控制台 API 的示例项目。相关仓库包括：Windows Terminal 文档（仓库：为文档做贡献）、控制台 API 文档、Cascadia Code 字体。

目录

• 安装和运行 Windows Terminal
  • Microsoft Store [推荐]
  • 其他安装方法
    • 通过 GitHub
    • 通过 Windows 程序包管理器 CLI（即 winget）
    • 通过 Chocolatey（非官方）
    • 通过 Scoop（非官方）
• 安装 Windows Terminal Canary
• 终端和控制台概述
  • Windows Terminal
  • Windows 控制台主机
  • 共享组件
• 创建全新 Windows Terminal
• 资源
• 常见问题解答
• 文档
• 贡献代码
• 与团队沟通
• 开发者指南
  • 前提条件
  • 构建代码
    • 在 PowerShell 中构建
    • 在 Cmd 中构建
  • 运行与调试
  • 编码指南
• 行为准则

安装和运行 Windows Terminal

注意：Windows Terminal 需要 Windows 10 2004（版本 19041）或更高版本。

Microsoft Store [推荐]

从 Microsoft Store 安装 Windows Terminal。这样，当发布新版本时，可以通过自动更新始终使用最新版本，这是推荐的安装方式。

其他安装方法

通过 GitHub

对于无法从 Microsoft Store 安装 Windows Terminal 的用户，可以从本仓库的“发布版本”页面手动下载已发布的版本。从“Assets”部分下载 `Microsoft.WindowsTerminal_.msixbundle` 文件。要安装该应用，只需双击 `.msixbundle` 文件，应用安装程序将自动运行。如果由于某种原因安装失败，可以在 PowerShell 提示符下尝试以下命令：

# 注意：如果你使用的是 PowerShell 7+，请在使用 Add-AppxPackage 之前运行以下命令# Import-Module Appx -UseWindowsPowerShellAdd-AppxPackage Microsoft.WindowsTerminal_.msixbundle

注意：如果手动安装终端：可能需要安装 VC++ v14 桌面框架包。这仅在较旧版本的 Windows 10 上可能需要，并且仅当遇到缺少框架包的错误时才需要；当发布新版本时，终端不会自动更新，因此需要定期安装最新的终端版本，以获得所有最新的修复和改进！

通过 Windows 程序包管理器 CLI（即 winget）

winget 用户可以通过安装 `Microsoft.WindowsTerminal` 包来下载并安装最新的终端版本：

winget install --id Microsoft.WindowsTerminal -e

注意：依赖项支持在 WinGet 1.6.2631 或更高版本中可用。要安装终端稳定版 1.18 或更高版本，请确保使用的是更新后的 WinGet 客户端。

通过 Chocolatey（非官方）

Chocolatey 用户可以通过安装 `microsoft-windows-terminal` 包来下载并安装最新的终端版本：

choco install microsoft-windows-terminal

要使用 Chocolatey 升级 Windows Terminal，请运行以下命令：

choco upgrade microsoft-windows-terminal

如果在安装/升级包时遇到任何问题，请访问 Windows Terminal 包页面，并按照 Chocolatey 问题处理流程操作。

通过 Scoop（非官方）

Scoop 用户可以通过安装 `windows-terminal` 包来下载并安装最新的终端版本：

scoop bucket add extrascoop install windows-terminal

要使用 Scoop 更新 Windows Terminal，请运行以下命令：

scoop update windows-terminal

如果在安装/更新包时遇到任何问题，请在 Scoop Extras 仓库的问题页面上搜索或报告问题。

安装 Windows Terminal Canary

Windows Terminal Canary 是 Windows Terminal 的每日构建版本。该版本包含主分支的最新代码，让用户有机会在新功能进入 Windows Terminal 预览版之前进行试用。Windows Terminal Canary 是最不稳定的版本，因此可能会在发现之前遇到一些 bug。

Windows Terminal Canary 提供应用安装程序分发版和便携式 ZIP 分发版。应用安装程序分发版支持自动更新。由于平台限制，此安装程序仅适用于 Windows 11。便携式 ZIP 分发版是一个便携式应用程序，它不会自动更新，也不会自动检查更新。此便携式 ZIP 分发版适用于 Windows 10（19041+）和 Windows 11。

了解更多关于 Windows Terminal 分发版的类型。

终端和控制台概述

在深入研究代码之前，请花几分钟时间阅读以下概述。

Windows Terminal

Windows Terminal 是一款全新的、现代化的、功能丰富且高效的终端应用程序，专为命令行用户设计。它包含了许多 Windows 命令行社区最常请求的功能，包括对标签页、富文本、全球化、可配置性、主题和样式等的支持。同时，终端还需要满足目标和指标，以确保其保持快速高效，不会消耗大量内存或电量。

Windows 控制台主机

Windows 控制台主机 `conhost.exe` 是 Windows 最初的命令行用户体验。它还承载了 Windows 的命令行基础设施、Windows 控制台 API 服务器、输入引擎、渲染引擎、用户偏好设置等。本仓库中的控制台主机代码是 Windows 中 `conhost.exe` 的实际构建源。自 2014 年接管 Windows 命令行以来，团队为控制台添加了几个新功能，包括背景透明、基于行的选择、对 ANSI / 虚拟终端序列的支持、24 位颜色、伪控制台（“ConPTY”）等。然而，由于 Windows 控制台的主要目标是保持向后兼容性，无法添加社区（和团队）多年来一直期望的许多功能，包括标签页、Unicode 文本和表情符号。这些限制促使创建了全新的 Windows Terminal。可以在命令行团队博客上的系列博客文章中了解更多关于命令行的演变，特别是 Windows 命令行的演变。

共享组件

在对 Windows 控制台进行全面改造时，对其代码库进行了大幅现代化改造，将逻辑实体清晰地分离成模块和类，引入了一些关键的可扩展性点，用更安全、更高效的 STL 容器替换了几个旧的自定义集合和容器，并使用 Microsoft 的 Windows 实现库（WIL）使代码更简单、更安全。这次改造使得控制台的几个关键组件可以在 Windows 上的任何终端实现中重复使用。这些组件包括一个新的基于 DirectWrite 的文本布局和渲染引擎、一个能够存储 UTF - 16 和 UTF - 8 的文本缓冲区、一个 VT 解析器/发射器等。

创建全新 Windows Terminal

在开始规划全新的 Windows Terminal 应用程序时，探索并评估了几种方法和技术栈。最终，决定继续在 C++ 代码库上投入精力，这样可以在现有的控制台和新终端中重用上述几个现代化组件。此外，意识到这将使能够将终端的大部分核心构建为一个可重用的 UI 控件，供其他人集成到他们自己的应用程序中。这项工作的成果包含在本仓库中，并作为 Windows Terminal 应用程序提供，可以从 Microsoft Store 下载，也可以直接从本仓库的发布版本中下载。

资源

有关 Windows Terminal 的更多信息，可能会发现以下资源有用且有趣：命令行博客、命令行背景知识博客系列、Windows Terminal 发布：终端“宣传视频”、Windows Terminal 发布：Build 2019 会议、Run As Radio：第 645 期 - 与 Richard Turner 聊 Windows Terminal、Azure DevOps 播客：第 54 期 - Kayla Cinnamon 和 Rich Turner 谈 Windows Terminal 上的 DevOps、Microsoft Ignite 2019 会议：现代 Windows 命令行：Windows Terminal - BRK3321。

常见问题解答

我构建并运行了新终端，但它看起来和旧控制台一样

原因：在 Visual Studio 中启动了错误的解决方案。解决方案：确保在 Visual Studio 中构建并部署 `CascadiaPackage` 项目。注意：`OpenConsole.exe` 只是一个本地构建的 `conhost.exe`，是承载 Windows 命令行基础设施的经典 Windows 控制台。Windows Terminal 使用 `OpenConsole` 来连接命令行应用程序并与之通信（通过 ConPty）。

文档

所有项目文档位于 aka.ms/terminal - docs。如果想为文档做出贡献，请在 Windows Terminal 文档仓库中提交拉取请求。

贡献代码

很高兴能与出色的社区一起构建和改进 Windows Terminal！在开始进行功能开发或修复之前，请阅读并遵循贡献者指南，以避免任何浪费或重复的工作。

与团队沟通

与团队沟通的最简单方法是通过 GitHub 问题。请提交新问题、功能请求和建议，但在创建新问题之前，请先搜索是否有类似的已打开或已关闭的现有问题。如果有一个认为暂时不需要创建问题的问题，请通过 Twitter 联系：Christopher Nguyen，产品经理：@nguyen_dows；Dustin Howett，工程主管：@dhowett；Mike Griese，资深开发者：@zadjii@mastodon.social；Carlos Zamora，开发者：@cazamor_msft；Pankaj Bhojwani，开发者；Leonard Hecker，开发者：@LeonardHecker。

开发者指南

前提条件

可以通过以下两种方式之一配置环境以构建终端。

使用 WinGet 配置文件

克隆仓库后，可以使用 WinGet 配置文件来设置环境。默认配置文件会安装 Visual Studio 2026 社区版及其他所需工具。在 `.config` 目录中还有另外两种适用于 Visual Studio 2026 企业版和专业版的配置文件变体。要运行默认配置文件，可以从资源管理器中双击该文件，也可以运行以下命令：

winget configure .config\configuration.winget

手动配置

• 必须运行 Windows 10 2004（版本 >= 10.0.19041.0）或更高版本才能运行 Windows Terminal。
• 必须在 Windows 设置应用中启用开发人员模式，才能在本地安装和运行 Windows Terminal。
• 必须安装 PowerShell 7 或更高版本。
• 必须安装 Windows 11（10.0.26100）SDK，版本为 10.0.26100.8249 或更高。
• 必须至少安装 VS 2026 版本 18.6。
• 必须通过 VS 安装程序安装以下工作负载。注意：打开解决方案时会提示自动安装缺失的组件：使用 C++ 进行桌面开发；WinUI 应用程序开发。
• 必须安装 .NET Framework 4.7.2 目标包才能构建测试项目。

构建代码

`OpenConsole.slnx` 可以在 Visual Studio 中构建，也可以使用 `/tools` 目录中的一组便捷脚本和工具从命令行构建。

在 PowerShell 中构建

Import-Module .\tools\OpenConsole.psm1Set-MsBuildDevEnvironmentInvoke-OpenConsoleBuild

在 Cmd 中构建

.\tools\razzle.cmd bcz

运行与调试

要在 VS 中调试 Windows Terminal，请在“解决方案资源管理器”中右键单击 `CascadiaPackage` 并选择“属性”。在“调试”菜单中，将“应用程序进程”和“后台任务进程”更改为“仅本机”。然后，应该可以通过按 F5 来构建和调试终端项目。确保选择“x64”或“x86”平台 - 终端不能为“任何 CPU”构建（因为终端是一个 C++ 应用程序，而不是 C# 应用程序）。👉 不能通过直接运行 `WindowsTerminal.exe` 来启动终端。有关原因的更多详细信息，请参阅 #926、#4043。

编码指南

请阅读以下关于编码实践的简要文档。👉 如果发现这些文档中缺少某些内容，请随时为仓库中任何位置的文档文件做出贡献（或编写一些新文档！）。随着了解为了让人们有效地为项目做出贡献需要提供哪些内容，这是一个持续改进的过程。包括编码风格、代码组织、旧代码库中的异常处理、在 WIL 中与 Windows 交互的有用智能指针和宏。

行为准则

本项目采用了 Microsoft 开源行为准则。有关更多信息，请参阅行为准则常见问题解答，或通过 opencode@microsoft.com 联系，提出任何额外的问题或意见。