Go-Colortext 终端彩色文本输出库使用指南

go-colortext 是一个简单易用的 Golang 库，用于在终端输出彩色文本。下面我将详细介绍它的使用方法。

安装

go get github.com/daviddengcn/go-colortext

基本用法

package main

import (
	ct "github.com/daviddengcn/go-colortext"
)

func main() {
	// 改变后续文本颜色
	ct.ChangeColor(ct.Red, true, ct.None, false)
	println("红色文本")
	
	// 重置颜色
	ct.ResetColor()
	println("默认颜色")
	
	// 直接打印彩色文本
	ct.Println(ct.Green, true, "绿色加粗文本")
	
	// 使用颜色常量
	ct.Printf(ct.Yellow, false, ct.Blue, "黄色文本在蓝色背景上\n")
}

颜色常量

go-colortext 提供了以下颜色常量：

const (
	None = iota
	Black
	Red
	Green
	Yellow
	Blue
	Magenta
	Cyan
	White
)

主要函数

1. ChangeColor

func ChangeColor(color Color, bright bool, bgColor Color, bgBright bool)

• color: 文本颜色
• bright: 是否高亮/加粗
• bgColor: 背景颜色
• bgBright: 背景是否高亮

示例：

ct.ChangeColor(ct.Magenta, true, ct.Black, false)
fmt.Println("紫色加粗文本，黑色背景")
ct.ResetColor()

2. ResetColor

重置为终端默认颜色。

3. Print/Println/Printf

直接打印彩色文本的便捷方法：

func Print(color Color, bright bool, v ...interface{})
func Println(color Color, bright bool, v ...interface{}) 
func Printf(color Color, bright bool, format string, a ...interface{})

示例：

ct.Println(ct.Cyan, false, "青色普通文本")
ct.Printf(ct.White, true, ct.Red, "白色加粗文本在红色背景上: %d\n", 42)

完整示例

package main

import (
	"fmt"
	ct "github.com/daviddengcn/go-colortext"
)

func main() {
	// 简单颜色示例
	colors := []ct.Color{ct.Red, ct.Green, ct.Yellow, ct.Blue, ct.Magenta, ct.Cyan}
	for i, c := range colors {
		ct.Printf(c, true, "颜色 %d\n", i+1)
	}
	ct.ResetColor()

	// 表格样式示例
	headers := []string{"ID", "Name", "Status"}
	data := [][]string{
		{"1", "Alice", "Active"},
		{"2", "Bob", "Inactive"},
		{"3", "Charlie", "Pending"},
	}

	// 打印表头
	ct.ChangeColor(ct.White, true, ct.Blue, false)
	for _, h := range headers {
		fmt.Printf("| %-10s ", h)
	}
	fmt.Println("|")
	ct.ResetColor()

	// 打印数据行
	for i, row := range data {
		color := ct.Green
		if i%2 == 0 {
			color = ct.Cyan
		}
		ct.ChangeColor(color, false, ct.None, false)
		for _, cell := range row {
			fmt.Printf("| %-10s ", cell)
		}
		fmt.Println("|")
	}
	ct.ResetColor()

	// 错误消息示例
	ct.Println(ct.Red, true, "错误: 文件未找到!")
	
	// 警告消息示例
	ct.Println(ct.Yellow, true, "警告: 磁盘空间不足")
	
	// 成功消息示例
	ct.Println(ct.Green, true, "成功: 操作已完成")
}

注意事项

1. 不是所有终端都支持彩色输出，特别是在Windows上可能需要额外配置
2. 使用后最好调用 ResetColor() 恢复默认颜色，以免影响后续输出
3. 颜色在重定向到文件时通常不会显示
4. 对于更复杂的终端UI，可以考虑更强大的库如 termbox-go 或 tcell

go-colortext 是一个轻量级的解决方案，适合简单的彩色文本输出需求。它的API简单直接，是快速为命令行程序添加颜色的好选择。