引言：控制台表格输出的挑战
在java应用程序中，我们经常需要在控制台输出结构化的表格数据，例如股票列表、用户报告等。最直观的方式是使用循环遍历数据数组，并通过制表符（\t）来分隔列。然而，当表格中的不同数据项（如股票名称、代码、价格等）长度不一致时，单纯依靠制表符往往会导致列无法对齐，使得输出结果杂乱无章，难以阅读。
例如，考虑以下使用制表符尝试打印股票信息的代码片段：
// 假设有以下数据
String[] stockNameList = {"Saudi Aramco", "SABIC", "Alinam Bank"};
String[] stockSymbol = {"2222.SR", "2010.SR", "1150.SR"};
double[] previousClosingPrice = {30.91, 89.29, 12.3};
double[] currentPrice = {35.85, 88.8, 36.5};
System.out.println("Stock Name\t" + "Stock Symbol\t" + "Previous Closing Price\t" + "Current Price\t" + "Change Percent\t");
for (int i = 0; i < stockNameList.length; i++) {
// 模拟计算涨跌幅百分比
double changePercent = ((currentPrice[i] - previousClosingPrice[i]) / previousClosingPrice[i]) * 100;
System.out.printf("%s\t%s\t%.2f\t%.2f\t%.2f%%\t%n",
stockNameList[i], stockSymbol[i], previousClosingPrice[i],
currentPrice[i], changePercent);
}其输出效果可能如下所示，明显存在列不对齐的问题：
Stock Name Stock Symbol Previous Closing Price Current Price Change Percent Saudi Aramco 2222.SR 30.91 35.85 15.98% SABIC 2010.SR 89.29 88.80 -0.55% Alinam Bank 1150.SR 12.30 36.50 196.75%
由于"Saudi Aramco"比"SABIC"长，导致后续列的位置发生偏移。为了解决这一问题，我们需要一种机制来确保每列数据都占据一个固定的宽度，无论其内容实际长度如何。
解决方案：固定宽度字符串填充
实现精确列对齐的核心思想是为表格中的每个单元格预设一个固定的宽度。如果单元格内容不足该宽度，则用空格填充；如果超出该宽度，则通常会完整显示（可能破坏对齐，或需要额外处理如截断）。Java的String.format()方法提供了强大的字符串格式化能力，正是解决此问题的理想工具。
立即学习“Java免费学习笔记（深入）”；
我们将创建一个辅助方法，该方法接受一个字符串和目标宽度，然后返回一个填充到指定宽度的字符串。
实现细节：padString方法解析
padString方法利用String.format()的格式化字符串来完成填充任务。
public class TableFormatter {
/**
* 将给定的字符串填充到指定长度，实现左对齐。
* 如果字符串长度小于指定长度，则在右侧用空格填充。
* 如果字符串长度大于指定长度，则原样返回字符串（不会截断）。
*
* @param s 要填充的字符串
* @param len 目标总长度
* @return 填充后的字符串
*/
public static String padString(String s, int len) {
// 构建格式化字符串，例如 "%-20s"
// %: 格式化说明符的开始
// -: 左对齐标志（默认是右对齐）
// len: 字段的最小宽度
// s: 字符串类型参数
String formatString = "%-" + len + "s";
return String.format(formatString, s);
}
// 主方法，用于演示如何使用padString
public static void main(String[] args) {
// 示例数据
String[] stockNameList = {"Saudi Aramco", "SABIC", "Alinam Bank"};
String[] stockSymbol = {"2222.SR", "2010.SR", "1150.SR"};
double[] previousClosingPrice = {30.91, 89.29, 12.3};
double[] currentPrice = {35.85, 88.8, 36.5};
// 定义每列的宽度
int nameColWidth = 20;
int symbolColWidth = 15;
int prevPriceColWidth = 20;
int currentPriceColWidth = 15;
int changePercentColWidth = 15;
// 打印表头
System.out.println(
padString("Stock Name", nameColWidth) +
padString("Stock Symbol", symbolColWidth) +
padString("Previous Closing Price", prevPriceColWidth) +
padString("Current Price", currentPriceColWidth) +
padString("Change Percent", changePercentColWidth)
);
// 打印分隔线（可选，增强可读性）
System.out.println(
"-".repeat(nameColWidth) +
"-".repeat(symbolColWidth) +
"-".repeat(prevPriceColWidth) +
"-".repeat(currentPriceColWidth) +
"-".repeat(changePercentColWidth)
);
// 循环打印数据行
for (int i = 0; i < stockNameList.length; i++) {
double changePercent = ((currentPrice[i] - previousClosingPrice[i]) / previousClosingPrice[i]) * 100;
// 格式化数字为字符串，并控制小数位数
String prevPriceStr = String.format("%.2f", previousClosingPrice[i]);
String currentPriceStr = String.format("%.2f", currentPrice[i]);
String changePercentStr = String.format("%.2f%%", changePercent); // 包含百分号
System.out.println(
padString(stockNameList[i], nameColWidth) +
padString(stockSymbol[i], symbolColWidth) +
padString(prevPriceStr, prevPriceColWidth) +
padString(currentPriceStr, currentPriceColWidth) +
padString(changePercentStr, changePercentColWidth)
);
}
}
}代码解析：
-
padString(String s, int len) 方法：
- 接收两个参数：s 是要处理的原始字符串，len 是目标总长度。
- String formatString = "%-" + len + "s"; 这是关键。它构建了一个格式化字符串，例如当 len 为 20 时，formatString 会是 %-20s。
- %：表示这是一个格式化说明符的开始。
- -：这是一个标志，表示输出应该左对齐。如果没有这个标志，默认是右对齐。
- len：这是一个整数，表示输出字段的最小宽度。如果字符串 s 的长度小于 len，则会在右侧填充空格直到达到 len 宽度。
- s：表示要格式化的参数是一个字符串。
- return String.format(formatString, s); 使用构建好的格式化字符串和原始字符串 s 来生成最终的、固定宽度的字符串。
-
main 方法中的应用：
- 首先，为每个列定义了一个合适的 ColWidth，这是根据预期数据长度和可读性来设定的。
- 无论是表头还是数据行，都统一调用 padString 方法来处理每个单元格的文本，确保它们都占据了预设的宽度。
- 对于数值类型数据，例如价格和百分比，需要先使用 String.format() 将它们格式化为字符串（例如 %.2f 控制两位小数），然后再传递给 padString 进行宽度填充。这样可以同时控制数值的精度和列的对齐。
预期输出：
Stock Name Stock Symbol Previous Closing PriceCurrent Price Change Percent ------------------------------------------------------------------------------------- Saudi Aramco 2222.SR 30.91 35.85 15.98% SABIC 2010.SR 89.29 88.80 -0.55% Alinam Bank 1150.SR 12.30 36.50 196.75%
可以看到，所有列都整齐地对齐了，大大提升了输出的可读性。
注意事项与优化
-
列宽的选择：
- 合理设定 len 至关重要。它应该足够容纳该列中最长的数据项，包括表头。如果数据项长度普遍较短，可以适当缩小 len 以节省屏幕空间。
- 在实际应用中，可以动态计算每列的最大内容长度，然后在此基础上增加少量余量来确定 len，以适应不同数据集。
-
数据溢出处理：
- String.format("%-len s", s) 的一个特性是，如果 s 的长度超过 len，它不会截断 s，而是完整输出 s，这可能会破坏该行的对齐。
- 为了避免这种情况，可以在调用 padString 之前，对过长的字符串进行截断处理，例如：
String truncatedS = (s.length() > len) ? s.substring(0, len - 3) + "..." : s; // 然后将 truncatedS 传递给 padString
这种处理方式需要权衡信息完整性和对齐美观性。
-
通用性：
- padString 方法非常通用，不仅限于表格输出，任何需要固定宽度文本输出的场景（如日志格式化、报告生成等）都可以使用。
-
性能考量：
- 对于一般的控制台输出，字符串拼接和格式化操作的性能开销通常可以忽略不计。但在处理极大量数据并频繁进行字符串操作时，应注意其潜在的性能影响。
-
替代方案：
- 对于更复杂的表格布局需求，或者需要跨平台兼容的富文本输出，可以考虑使用专门的表格打印库（如 TextTable 或 Apache Commons Text 中的 StrBuilder 等），它们提供了更高级的特性，如边框、合并单元格等。然而，对于简单的控制台对齐，String.format 提供的方案足够高效和灵活。
总结
通过自定义 padString 辅助方法，并巧妙利用 String.format() 的左对齐格式化功能（%-len s），我们能够有效地解决Java控制台输出中表格数据列不对齐的问题。这种方法简单、高效且易于理解，能够显著提升控制台输出的可读性和专业性，是Java开发者在处理结构化文本输出时一项非常实用的技巧。掌握这一技术，将使你的控制台输出更加清晰、美观。
