介绍 PowerShell 中可用于 ANSI 转义序列的支持。

PowerShell 具有许多功能，支持使用 ANSI 转义序列来控制托管 PowerShell 的终端应用程序中的输出呈现。

PowerShell 7.2 添加了新的自动变量 $PSStyle，并对 PowerShell 引擎进行了更改，以支持 ANSI 修饰文本的输出。

ANSI 功能旨在与基于 xterm 的终端兼容。 有关详细信息，请参阅维基百科中的 xterm。

在 Windows 10 及更高版本上，Windows 控制台主机与 xterm 兼容。 Windows 终端应用程序也与 xterm 兼容。

在 macOS 上，默认终端应用程序与 xterm 兼容。

对于 Linux，每个发行版都附带不同的终端应用程序。 请查阅发行版的文档以找到合适的终端应用程序。

该变量具有以下属性：

基成员会返回映射到其名称的 ANSI 转义序列的字符串。 值可设置为允许自定义。 例如，可以将粗体更改为加下划线。 属性名称使你能够更轻松地使用 Tab 补全创建修饰字符串：

以下成员控制如何或何时使用 ANSI 格式：

$PSStyle.OutputRendering 是一个 System.Management.Automation.OutputRendering 枚举，其值包括：

ANSI：转义序列始终按原样传递。

重要

将输出重定向到要在下游执行的文件或管道时，应使用 ANSI 模式。 这可以确保不会改变输出。 使用任何其他模式都会通过删除 ANSI 转义序列来改变输出，这可能会改变执行行为。

PlainText：ANSI 转义序列始终被剥离，因此它只是纯文本。 在远程会话中，如果远程主机设置为 PlainText，则输出会去除 ANSI 转义序列，然后再将其发送回本地客户端。

Host：这是默认行为。 ANSI 转义序列已从重定向或管道输出中删除。 有关详细信息，请参阅重定向输出。

$PSStyle.Background 和 $PSStyle.Foreground 成员是包含 16 种标准控制台颜色的 ANSI 转义序列的字符串。

这些值是可设置的，可以包含任意数量的 ANSI 转义序列。 此外，FromRgb() 方法可以指定 24 位颜色。 可通过两种方法调用 FromRgb() 方法。

以下任一示例可将背景色设置为 24 位颜色 Beige。

$PSStyle.Formatting 是一个嵌套对象，用于控制调试、错误、详细、警告消息以及列表和表标头的默认格式。 还可以控制粗体和下划线等属性。 它取代了 $Host.PrivateData，作为管理格式化渲染颜色的方式。 $Host.PrivateData 继续存在以实现向后兼容性，但不连接到 $PSStyle.Formatting。 $PSStyle.Formatting 包括以下成员：

$PSStyle.Progress 可以控制进度视图栏呈现。

注意

如果主机不支持虚拟终端，$PSStyle.Progress.View 会自动设置为 Classic。

下面的示例将呈现样式设置为最小进度栏。

$PSStyle.FileInfo 是一个嵌套对象，用于控制 fileInfo 对象的着色。

默认情况下，$PSStyle.OutputRendering 设置为 主机。 ANSI 转义序列已从重定向或管道输出中删除。

OutputRendering 仅适用于主机、Out-File 和 Out-String 中的呈现。 本机可执行文件的输出不受影响。

PowerShell 7.2.6 更改了以下方案中 Out-File 和 Out-String 的行为：

这是这些 cmdlet 与 PowerShell 7.2 相比的重大更改。

OutputRendering 不适用于 PowerShell 主机进程的输出，例如，从命令行运行 pwsh 并重定向输出时。

在以下示例中，PowerShell 在 Linux 上通过 bash 运行。 Get-ChildItem cmdlet 生成 ANSI 修饰的文本。 由于重定向发生在 bash 进程中，因此在 PowerShell 主机外部，输出不受 OutputRendering 影响。

检查 out.txt 的内容时，会看到 ANSI 转义序列。

相反，当重定向发生在 PowerShell 会话中时，OutputRendering 会影响重定向的输出。

检查 out.txt 的内容时，没有 ANSI 转义序列。

可使用 TERM 或 NO_COLOR 环境变量关闭对 ANSI 转义序列的支持。

以下 $env:TERM 的值按如下方式更改该行为：

如果存在 $env:NO_COLOR，则 $PSStyle.OutputRendering 设置为 PlainText。 有关 NO_COLOR 环境变量的详细信息，请参阅 https://no-color.org/。

C# 开发人员可以将 PSStyle 作为单一实例，如以下示例所示：

PSStyle 存在于 System.Management.Automation 命名空间中。

PowerShell 引擎包含以下更改：

PowerShell 7.4 向 [System.Management.Automation.PSStyle] 类添加了三个新的静态方法。

这些方法提供了一种将 ConsoleColor 值转换为 ANSI 转义序列的方法，用于前景和背景色或两者的组合。

以下示例显示了这些方法生成的 ANSI 转义序列。