Golang终端仪表盘开发：termdash和termui使用指南

在Golang中开发终端仪表盘，termdash和termui是两个非常流行的库。下面我将介绍它们的基本用法和示例代码。

1. termdash简介与使用

termdash是一个功能丰富的终端仪表盘库，提供了灵活的布局系统和多种组件。

基本示例

package main

import (
	"context"
	"fmt"
	"time"

	"github.com/mum4k/termdash"
	"github.com/mum4k/termdash/cell"
	"github.com/mum4k/termdash/container"
	"github.com/mum4k/termdash/linestyle"
	"github.com/mum4k/termdash/terminal/termbox"
	"github.com/mum4k/termdash/terminal/terminalapi"
	"github.com/mum4k/termdash/widgets/text"
)

func main() {
	// 初始化终端
	t, err := termbox.New()
	if err != nil {
		panic(err)
	}
	defer t.Close()

	ctx, cancel := context.WithCancel(context.Background())

	// 创建文本组件
	textWidget, err := text.New()
	if err != nil {
		panic(err)
	}

	// 更新文本内容
	go func() {
		ticker := time.NewTicker(1 * time.Second)
		defer ticker.Stop()

		for i := 0; ; i++ {
			select {
			case <-ticker.C:
				str := fmt.Sprintf("当前时间: %v\n计数器: %d", time.Now().Format("15:04:05"), i)
				if err := textWidget.Write(str, text.WriteReplace()); err != nil {
					panic(err)
				}
			case <-ctx.Done():
				return
			}
		}
	}()

	// 设置容器布局
	c, err := container.New(
		t,
		container.Border(linestyle.Light),
		container.BorderTitle("TERMDASH 仪表盘 (按ESC退出)"),
		container.BorderColor(cell.ColorYellow),
		container.PlaceWidget(textWidget),
	)
	if err != nil {
		panic(err)
	}

	// 设置键盘退出
	quitter := func(k *terminalapi.Keyboard) {
		if k.Key == 'q' || k.Key == keyboard.KeyEsc {
			cancel()
		}
	}

	// 启动仪表盘
	if err := termdash.Run(ctx, t, c, termdash.KeyboardSubscriber(quitter)); err != nil {
		panic(err)
	}
}

termdash主要特性

1. 灵活的布局系统：支持网格、行、列等多种布局方式
2. 丰富的组件：包括文本、图表、进度条等
3. 主题支持：可以自定义颜色和样式
4. 键盘和鼠标事件处理

2. termui简介与使用

termui是另一个流行的终端仪表盘库，API设计简洁。

基本示例

package main

import (
	"fmt"
	"log"
	"time"

	ui "github.com/gizak/termui/v3"
	"github.com/gizak/termui/v3/widgets"
)

func main() {
	// 初始化UI
	if err := ui.Init(); err != nil {
		log.Fatalf("初始化termui失败: %v", err)
	}
	defer ui.Close()

	// 创建段落组件
	p := widgets.NewParagraph()
	p.Title = "系统信息"
	p.Text = "正在加载数据..."
	p.SetRect(0, 0, 50, 5)
	p.BorderStyle.Fg = ui.ColorYellow

	// 创建列表组件
	l := widgets.NewList()
	l.Title = "日志"
	l.Rows = []string{
		"系统启动",
		"初始化完成",
	}
	l.SetRect(0, 5, 50, 12)
	l.TextStyle = ui.NewStyle(ui.ColorGreen)

	// 创建进度条
	g := widgets.NewGauge()
	g.Title = "CPU使用率"
	g.Percent = 50
	g.SetRect(0, 12, 50, 15)
	g.BarColor = ui.ColorRed
	g.BorderStyle.Fg = ui.ColorWhite

	// 渲染组件
	ui.Render(p, l, g)

	// 更新数据的goroutine
	go func() {
		ticker := time.NewTicker(time.Second)
		for range ticker.C {
			p.Text = fmt.Sprintf("当前时间: %v\n主机名: localhost", time.Now().Format("15:04:05"))
			g.Percent = (g.Percent + 10) % 100
			l.Rows = append(l.Rows, fmt.Sprintf("事件 %d", time.Now().Unix()))
			if len(l.Rows) > 10 {
				l.Rows = l.Rows[1:]
			}
			ui.Render(p, l, g)
		}
	}()

	// 事件循环
	uiEvents := ui.PollEvents()
	for {
		e := <-uiEvents
		switch e.ID {
		case "q", "<C-c>":
			return
		case "<Resize>":
			payload := e.Payload.(ui.Resize)
			p.SetRect(0, 0, payload.Width, 5)
			l.SetRect(0, 5, payload.Width, 12)
			g.SetRect(0, 12, payload.Width, 15)
			ui.Render(p, l, g)
		}
	}
}

termui主要特性

1. 简单易用的API：快速创建仪表盘
2. 响应式设计：自动处理终端大小变化
3. 多种内置组件：图表、表格、进度条等
4. 轻量级：依赖较少

3. 如何选择

• termdash适合更复杂的布局需求，有更精细的控制
• termui适合快速开发简单的仪表盘，学习曲线较低

4. 高级用法

termdash图表示例

// 在termdash中添加图表
lineChart, err := barchart.New(
	barchart.BarColors([]cell.Color{
		cell.ColorRed,
		cell.ColorGreen,
	}),
	barchart.ValueColors([]cell.Color{
		cell.ColorBlack,
		cell.ColorBlack,
	}),
	barchart.ShowValues(),
)

values := []int{10, 20, 30, 40, 50}
if err := lineChart.Values(values, 50); err != nil {
	panic(err)
}

termui图表示例

// 在termui中添加图表
bc := widgets.NewBarChart()
bc.Title = "Bar Chart"
bc.Data = []float64{3, 2, 5, 3, 9, 5, 3, 2, 5, 8, 3, 2}
bc.Labels = []string{"S0", "S1", "S2", "S3", "S4", "S5"}
bc.SetRect(50, 0, 100, 10)
bc.BarWidth = 5
bc.BarColors = []ui.Color{ui.ColorRed, ui.ColorGreen}
bc.LabelStyles = []ui.Style{ui.NewStyle(ui.ColorBlue)}
bc.NumStyles = []ui.Style{ui.NewStyle(ui.ColorYellow)}

5. 总结

termdash和termui都是优秀的Golang终端仪表盘库，选择哪个取决于项目需求：

1. 需要复杂布局和精细控制 → 选择termdash
2. 需要快速开发和简单实现 → 选择termui

两者都可以创建出功能丰富、视觉效果良好的终端仪表盘应用。