Golang终端应用高级ANSI样式与颜色支持插件库termenv的使用

termenv是一个Golang库，可让您安全地在终端上使用高级样式选项。它能收集终端环境的ANSI和颜色支持信息，并为您提供方便的方法来为输出着色和添加样式，而无需处理各种奇怪的ANSI转义序列和颜色转换。

主要特性

• 支持RGB/TrueColor
• 检测终端支持的颜色范围
• 自动将颜色转换为最佳匹配的可用颜色
• 终端主题（浅色/深色）检测
• 链式语法
• 嵌套样式

安装

go get github.com/muesli/termenv

基本用法

package main

import (
	"fmt"
	"os"

	"github.com/muesli/termenv"
)

func main() {
	// 创建输出对象
	output := termenv.NewOutput(os.Stdout)

	// 获取终端支持的profile
	profile := output.Profile
	fmt.Printf("终端支持的颜色profile: %v\n", profile)

	// 检查终端背景是否为深色
	darkTheme := output.HasDarkBackground()
	fmt.Printf("终端使用深色背景: %v\n", darkTheme)

	// 创建带样式的字符串
	s := output.String("Hello World")

	// 设置前景色(支持hex值)
	s = s.Foreground(output.Color("#abcdef"))
	// 设置背景色(支持ANSI颜色0-255)
	s = s.Background(output.Color("69"))

	// 输出带样式的字符串
	fmt.Println(s)
}

颜色支持

termenv支持多种颜色profile：Ascii（仅黑白）、ANSI（16色）、ANSI Extended（256色）和TrueColor（24位RGB）。颜色将自动降级为所需profile中最匹配的可用颜色：

TrueColor => ANSI 256 Colors => ANSI 16 Colors => Ascii

// 创建带样式的字符串
s := output.String("Hello World")

// 支持hex值
// 在不支持RGB的终端上会自动降级颜色
s.Foreground(output.Color("#abcdef"))
// 也支持ANSI颜色(0-255)
s.Background(output.Color("69"))
// 或color.Color接口
s.Foreground(output.FromColor(color.RGBA{255, 128, 0, 255}))

// 组合前景和背景色
s.Foreground(output.Color("#ffffff")).Background(output.Color("#0000ff"))

// 支持fmt.Stringer接口
fmt.Println(s)

文本样式

您可以使用链式语法组合自己的样式：

s := output.String("foobar")

// 文本样式
s.Bold()     // 粗体
s.Faint()    // 淡色
s.Italic()   // 斜体
s.CrossOut() // 删除线
s.Underline() // 下划线
s.Overline()  // 上划线

// 反转当前前景和背景色
s.Reverse()

// 闪烁文本
s.Blink()

// 组合多个选项
s.Bold().Underline()

完整示例

以下是一个完整的示例，展示了termenv的主要功能：

package main

import (
	"fmt"
	"image/color"
	"os"

	"github.com/muesli/termenv"
)

func main() {
	// 初始化输出
	output := termenv.NewOutput(os.Stdout)

	// 检测终端特性
	fmt.Println("终端特性检测:")
	fmt.Printf("Profile: %v\n", output.Profile)
	fmt.Printf("支持深色背景: %v\n", output.HasDarkBackground())
	fmt.Printf("前景色: %v\n", output.ForegroundColor())
	fmt.Printf("背景色: %v\n", output.BackgroundColor())

	// 基本样式示例
	fmt.Println("\n基本样式示例:")
	fmt.Println(output.String("普通文本"))
	fmt.Println(output.String("粗体文本").Bold())
	fmt.Println(output.String("斜体文本").Italic())
	fmt.Println(output.String("下划线文本").Underline())
	fmt.Println(output.String("删除线文本").CrossOut())
	fmt.Println(output.String("闪烁文本").Blink())

	// 颜色示例
	fmt.Println("\n颜色示例:")
	fmt.Println(output.String("红色文本").Foreground(output.Color("#ff0000")))
	fmt.Println(output.String("绿色背景").Background(output.Color("#00ff00")))
	fmt.Println(output.String("蓝色前景黄色背景").
		Foreground(output.Color("#0000ff")).
		Background(output.Color("#ffff00")))

	// 使用color.Color接口
	fmt.Println("\n使用color.Color接口:")
	c := color.RGBA{255, 0, 255, 255} // 洋红色
	fmt.Println(output.String("洋红色文本").Foreground(output.FromColor(c)))

	// 链式调用
	fmt.Println("\n链式调用示例:")
	styled := output.String("粗体+斜体+下划线+红色").
		Bold().
		Italic().
		Underline().
		Foreground(output.Color("#ff0000"))
	fmt.Println(styled)

	// 终端控制
	fmt.Println("\n终端控制示例:")
	output.MoveCursor(5, 0) // 移动光标到第5行开头
	fmt.Println("这行文本出现在第5行")
	output.CursorUp(2)     // 光标上移2行
	fmt.Println("这行文本出现在第3行")
	output.ClearLine()     // 清除当前行
}

终端控制

termenv还提供了丰富的终端控制功能：

// 移动光标到指定位置
output.MoveCursor(row, column)

// 保存光标位置
output.SaveCursorPosition()

// 恢复保存的光标位置
output.RestoreCursorPosition()

// 清除屏幕
output.ClearScreen()

// 清除当前行
output.ClearLine()

// 切换到备用屏幕
output.AltScreen()

// 退出备用屏幕
output.ExitAltScreen()

// 隐藏光标
output.HideCursor()

// 显示光标
output.ShowCursor()

Windows支持

在Windows上，您需要先启用ANSI处理：

restoreConsole, err := termenv.EnableVirtualTerminalProcessing(termenv.DefaultOutput())
if err != nil {
    panic(err)
}
defer restoreConsole()

termenv是一个功能强大且易于使用的终端样式库，可以帮助您创建美观的命令行应用程序。