Golang 文本对齐处理工具 align 库使用指南

align 是一个简单实用的 Go 语言文本对齐处理库，可以帮助你对文本进行左对齐、右对齐、居中对齐等操作。下面我将详细介绍如何使用这个库。

安装

首先安装 align 库：

go get github.com/guptarohit/asciigraph

基本使用方法

1. 左对齐

package main

import (
	"fmt"
	"github.com/guptarohit/asciigraph/align"
)

func main() {
	text := "Hello, World!"
	width := 20
	
	// 左对齐
	leftAligned := align.Left(text, width)
	fmt.Printf("'%s'\n", leftAligned)
	
	// 输出: 'Hello, World!       '
}

2. 右对齐

func main() {
	text := "Hello, World!"
	width := 20
	
	// 右对齐
	rightAligned := align.Right(text, width)
	fmt.Printf("'%s'\n", rightAligned)
	
	// 输出: '       Hello, World!'
}

3. 居中对齐

func main() {
	text := "Hello, World!"
	width := 20
	
	// 居中对齐
	centerAligned := align.Center(text, width)
	fmt.Printf("'%s'\n", centerAligned)
	
	// 输出: '   Hello, World!    '
}

高级用法

多行文本对齐

func main() {
	lines := []string{
		"First line",
		"Second line is longer",
		"Third",
	}
	
	// 找出最长行的长度
	maxWidth := 0
	for _, line := range lines {
		if len(line) > maxWidth {
			maxWidth = len(line)
		}
	}
	
	// 对齐所有行
	fmt.Println("Left aligned:")
	for _, line := range lines {
		fmt.Printf("'%s'\n", align.Left(line, maxWidth))
	}
	
	fmt.Println("\nRight aligned:")
	for _, line := range lines {
		fmt.Printf("'%s'\n", align.Right(line, maxWidth))
	}
	
	fmt.Println("\nCenter aligned:")
	for _, line := range lines {
		fmt.Printf("'%s'\n", align.Center(line, maxWidth))
	}
}

表格数据对齐

func main() {
	data := [][]string{
		{"Name", "Age", "City"},
		{"John Doe", "30", "New York"},
		{"Jane Smith", "25", "London"},
		{"Bob Johnson", "45", "Paris"},
	}
	
	// 计算每列的最大宽度
	colWidths := make([]int, len(data[0]))
	for _, row := range data {
		for i, cell := range row {
			if len(cell) > colWidths[i] {
				colWidths[i] = len(cell)
			}
		}
	}
	
	// 打印对齐的表格
	for _, row := range data {
		for i, cell := range row {
			fmt.Printf("| %s ", align.Left(cell, colWidths[i]))
		}
		fmt.Println("|")
	}
}

自定义填充字符

默认情况下，align 使用空格进行填充，但你可以自定义填充字符：

func main() {
	text := "Hello"
	width := 10
	
	// 自定义左对齐，使用'-'填充
	left := align.Left(text, width)
	leftCustom := left[:len(text)] + strings.Repeat("-", width-len(text))
	fmt.Printf("'%s'\n", leftCustom)
	
	// 输出: 'Hello-----'
}

注意事项

1. 如果文本长度大于指定的宽度，align 不会截断文本，而是原样返回
2. 对于包含多字节字符的文本（如中文），需要使用 utf8.RuneCountInString 替代 len 来计算字符数
3. 对齐操作不会处理换行符，多行文本需要先分割再分别对齐

性能考虑

对于大量文本处理，建议：

1. 预先计算好最大宽度
2. 批量处理文本而不是单行处理
3. 如果需要处理非常大的文件，考虑流式处理

align 库虽然简单，但在处理文本对齐时非常实用，特别是生成报表、格式化输出等场景。