使用simpletable生成Golang终端表格

simpletable是一个轻量级的Golang库，用于在终端中生成美观的表格。下面我将详细介绍它的使用方法。

安装

首先安装simpletable库：

go get github.com/alexeyco/simpletable

基本用法

1. 创建简单表格

package main

import (
	"github.com/alexeyco/simpletable"
)

func main() {
	// 创建表格
	table := simpletable.New()

	// 设置表头
	table.Header = &simpletable.Header{
		Cells: []*simpletable.Cell{
			{Align: simpletable.AlignCenter, Text: "ID"},
			{Align: simpletable.AlignCenter, Text: "Name"},
			{Align: simpletable.AlignCenter, Text: "Age"},
		},
	}

	// 添加数据行
	table.Body.Cells = [][]*simpletable.Cell{
		{
			{Align: simpletable.AlignRight, Text: "1"},
			{Text: "Alice"},
			{Align: simpletable.AlignRight, Text: "25"},
		},
		{
			{Align: simpletable.AlignRight, Text: "2"},
			{Text: "Bob"},
			{Align: simpletable.AlignRight, Text: "30"},
		},
		{
			{Align: simpletable.AlignRight, Text: "3"},
			{Text: "Charlie"},
			{Align: simpletable.AlignRight, Text: "35"},
		},
	}

	// 设置表格样式
	table.SetStyle(simpletable.StyleCompactLite)

	// 打印表格
	println(table.String())
}

2. 表格样式

simpletable提供了多种内置样式：

// 可用的样式
table.SetStyle(simpletable.StyleDefault)       // 默认样式
table.SetStyle(simpletable.StyleCompact)       // 紧凑样式
table.SetStyle(simpletable.StyleCompactLite)   // 更紧凑的样式
table.SetStyle(simpletable.StyleRounded)       // 圆角边框
table.SetStyle(simpletable.StyleMarkdown)      // Markdown风格

3. 添加页脚

// 添加页脚
table.Footer = &simpletable.Footer{
	Cells: []*simpletable.Cell{
		{Align: simpletable.AlignCenter, Span: 3, Text: "Total: 3 users"},
	},
}

4. 动态添加数据

// 动态添加行
addRow := func(id, name, age string) {
	r := []*simpletable.Cell{
		{Align: simpletable.AlignRight, Text: id},
		{Text: name},
		{Align: simpletable.AlignRight, Text: age},
	}
	table.Body.Cells = append(table.Body.Cells, r)
}

addRow("4", "David", "28")
addRow("5", "Eve", "32")

5. 完整示例

package main

import (
	"github.com/alexeyco/simpletable"
)

func main() {
	table := simpletable.New()

	// 表头
	table.Header = &simpletable.Header{
		Cells: []*simpletable.Cell{
			{Align: simpletable.AlignCenter, Text: "ID"},
			{Align: simpletable.AlignCenter, Text: "Name"},
			{Align: simpletable.AlignCenter, Text: "Age"},
			{Align: simpletable.AlignCenter, Text: "Salary"},
		},
	}

	// 数据
	data := [][]interface{}{
		{1, "Alice", 25, 50000.50},
		{2, "Bob", 30, 75000.75},
		{3, "Charlie", 35, 100000.00},
	}

	// 添加数据行
	for _, row := range data {
		r := []*simpletable.Cell{
			{Align: simpletable.AlignRight, Text: fmt.Sprintf("%d", row[0])},
			{Text: fmt.Sprintf("%s", row[1])},
			{Align: simpletable.AlignRight, Text: fmt.Sprintf("%d", row[2])},
			{Align: simpletable.AlignRight, Text: fmt.Sprintf("$%.2f", row[3])},
		}
		table.Body.Cells = append(table.Body.Cells, r)
	}

	// 页脚
	table.Footer = &simpletable.Footer{
		Cells: []*simpletable.Cell{
			{Align: simpletable.AlignRight, Span: 3, Text: "Total"},
			{Align: simpletable.AlignRight, Text: "$225,001.25"},
		},
	}

	// 设置样式
	table.SetStyle(simpletable.StyleRounded)

	// 打印表格
	println(table.String())
}

高级功能

1. 自定义样式

// 创建自定义样式
myStyle := simpletable.Style{
	Border: &simpletable.BorderStyle{
		Top:    "=",
		Bottom: "=",
		Left:   "|",
		Right:  "|",
	},
	Divider: &simpletable.DividerStyle{
		Top:    "-",
		Bottom: "-",
		Left:   "|",
		Right:  "|",
	},
}

table.SetStyle(myStyle)

2. 合并单元格

// 合并单元格示例
table.Body.Cells = [][]*simpletable.Cell{
	{
		{Align: simpletable.AlignCenter, Span: 4, Text: "Employee Data"},
	},
	// 其他行...
}

3. 颜色支持

simpletable本身不直接支持颜色，但你可以使用其他库如fatih/color来添加颜色：

import "github.com/fatih/color"

// 使用颜色
red := color.New(color.FgRed).SprintFunc()
table.Body.Cells = append(table.Body.Cells, []*simpletable.Cell{
	{Text: red("Warning")},
	{Text: "This is important"},
})

总结

simpletable是一个简单易用的终端表格生成库，适合在CLI应用中展示结构化数据。它支持：

• 多种内置样式
• 表头和页脚
• 单元格对齐方式
• 单元格合并
• 自定义样式

对于更复杂的需求，你可能需要查看更强大的库如olekukonko/tablewriter，但对于大多数简单场景，simpletable已经足够用了。