Rust表格渲染库nu-table使用指南

nu-table是一个为命令行和终端应用提供美观表格格式化功能的Rust库。它源自流行的nushell项目，现作为独立库供开发者使用。

安装

在Cargo.toml中添加依赖：

[dependencies]
nu-table = "0.2"

基本使用

创建简单表格

use nu_table::{Table, TableTheme};

fn main() {
    let mut table = Table::new();
    table.set_theme(TableTheme::rounded());
    
    // 添加表头
    table.set_header(vec!["Name", "Age", "City"]);
    
    // 添加数据行
    table.add_row(vec!["Alice", "28", "New York"]);
    table.add_row(vec!["Bob", "32", "London"]);
    table.add_row(vec!["Charlie", "24", "Paris"]);
    
    println!("{}", table.render());
}

输出效果

╭─────────┬─────┬──────────╮
│ Name    │ Age │ City     │
├─────────┼─────┼──────────┤
│ Alice   │ 28  │ New York │
│ Bob     │ 32  │ London   │
│ Charlie │ 24  │ Paris    │
╰─────────┴─────┴──────────╯

高级功能

自定义主题

use nu_table::{Table, TableTheme};

fn main() {
    let mut table = Table::new();
    
    // 创建自定义主题
    let mut theme = TableTheme::rounded();
    theme.vertical = '│';
    theme.horizontal = '─';
    theme.intersection_top = '┬';
    
    table.set_theme(theme);
    table.set_header(vec!["ID", "Value"]);
    table.add_row(vec!["1", "First"]);
    table.add_row(vec!["2", "Second"]);
    
    println!("{}", table.render());
}

对齐方式

use nu_table::{Table, TableTheme, Alignment};

fn main() {
    let mut table = Table::new();
    table.set_theme(TableTheme::rounded());
    
    table.set_header(vec!["Left", "Center", "Right"]);
    
    // 设置列对齐
    table.set_alignments(vec![
        Alignment::Left,
        Alignment::Center,
        Alignment::Right
    ]);
    
    table.add_row(vec!["A", "B", "C"]);
    table.add_row(vec!["Longer text", "Center me", "12345"]);
    
    println!("{}", table.render());
}

颜色支持

use nu_table::{Table, TableTheme};
use nu_ansi_term::{Color, Style};

fn main() {
    let mut table = Table::new();
    table.set_theme(TableTheme::rounded());
    
    // 设置带颜色的表头
    table.set_header(vec![
        Style::new().fg(Color::Red).bold().paint("Name").to_string(),
        Style::new().fg(Color::Blue).paint("Score").to_string()
    ]);
    
    table.add_row(vec![
        "Alice".to_string(),
        Color::Green.paint("95").to_string()
    ]);
    
    println!("{}", table.render());
}

从数据结构创建表格

use nu_table::{Table, TableTheme};
use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize)]
struct Person {
    name: String,
    age: u8,
    city: String,
}

fn main() {
    let data = vec![
        Person { name: "Alice".into(), age: 28, city: "New York".into() },
        Person { name: "Bob".into(), age: 32, city: "London".into() },
    ];
    
    let mut table = Table::new();
    table.set_theme(TableTheme::rounded());
    
    // 从结构体创建表格
    table.set_header(vec!["Name", "Age", "City"]);
    for person in data {
        table.add_row(vec![
            person.name,
            person.age.to_string(),
            person.city
        ]);
    }
    
    println!("{}", table.render());
}

完整示例demo

use nu_table::{Table, TableTheme, Alignment};
use nu_ansi_term::{Color, Style};
use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize)]
struct Product {
    id: u32,
    name: String,
    price: f64,
    in_stock: bool,
}

fn main() {
    // 示例数据
    let products = vec![
        Product { id: 1, name: "Laptop".into(), price: 999.99, in_stock: true },
        Product { id: 2, name: "Mouse".into(), price: 24.95, in_stock: true },
        Product { id: 3, name: "Keyboard".into(), price: 49.99, in_stock: false },
    ];

    // 创建表格实例
    let mut table = Table::new();
    table.set_theme(TableTheme::rounded());
    
    // 设置带颜色的表头
    table.set_header(vec![
        Style::new().fg(Color::Green).bold().paint("ID").to_string(),
        Style::new().fg(Color::Blue).bold().paint("Product").to_string(),
        Style::new().fg(Color::Yellow).bold().paint("Price").to_string(),
        Style::new().fg(Color::Red).bold().paint("Stock").to_string(),
    ]);
    
    // 设置列对齐方式
    table.set_alignments(vec![
        Alignment::Center,
        Alignment::Left,
        Alignment::Right,
        Alignment::Center,
    ]);
    
    // 添加数据行
    for product in products {
        let stock_status = if product.in_stock {
            Color::Green.paint("In Stock").to_string()
        } else {
            Color::Red.paint("Out of Stock").to_string()
        };
        
        table.add_row(vec![
            product.id.to_string(),
            product.name,
            format!("${:.2}", product.price),
            stock_status,
        ]);
    }
    
    // 渲染并打印表格
    println!("{}", table.render());
}

输出效果

╭────┬──────────┬────────┬─────────────╮
│ ID │ Product  │  Price │ Stock       │
├────┼──────────┼────────┼─────────────┤
│ 1  │ Laptop   │ $999.99│ In Stock    │
│ 2  │ Mouse    │  $24.95│ In Stock    │
│ 3  │ Keyboard │  $49.99│ Out of Stock│
╰────┴──────────┴────────┴─────────────╯

注意事项

1. nu-table会自动根据终端宽度调整表格大小
2. 支持UTF-8字符和多行文本
3. 可以通过table.set_width()手动设置表格宽度
4. 对于大量数据，考虑分批渲染以提高性能

nu-table是一个功能强大且易于使用的表格渲染库，特别适合需要美观命令行输出的Rust应用程序。