如何用 Java 二维数组实现对齐的表格输出

本文教你使用二维字符串数组构建国家与首都对照表,并通过动态计算列宽、添加空格填充,实现美观的左对齐表格格式输出。

在 Java 中,用二维数组(如 String[][])模拟表格结构是一种常见且实用的入门实践。但要让输出真正呈现为“表格”——即各列文字垂直对齐——关键不在于存储数据,而在于格式化输出。原始代码中嵌套循环逐个打印元素,导致每行拆成两行输出(国家一行、首都一行),完全破坏了表格结构;更严重的是,缺乏列宽控制,文字自然左靠拢后无法对齐。

解决思路分为三步:分离关注点、计算最大列宽、按需补空格。以下是一个清晰、可维护的专业写法:

public class Arrays39 {
    public static void main(String[] args) {
        String[][] countries = {
            {"Mexico", "DF"},
            {"Guatemala", "Guatemala City"},
            {"El Salvador", "El Salvador"},
            {"Russia", "Moscow"}
        };
        int maxCountryLength = maxPadding(countries);
        generateTable(countries, maxCountryLength);
    }

    // 主输出方法:打印表头 + 每行数据(国家 + 空格填充 + 首都)
    public static void generateTable(String[][] data, int padding) {
        // 表头:Country 后补足 padding 空格,再接 Capital
        System.out.printf("Country%sCapital%n", " ".repeat(Math.max(0, padding - "Country".length() + 1)));
        for (String[] row : data) {
            String country = row[0];
            String capital = row[1];
            // 计算当前国家名需补充的空格数(使所有国家列右边界对齐)
            int spacesNeeded = Math.max(0, padding - country.length() + 1);
            System.out.printf("%s%s%s%n", country, " ".repeat(spacesNeeded), capital);
        }
    }

    // 辅助方法:找出第一列(国家名)中最长字符串的长度
    private static int maxPadding(String[][] data) {
        int max = 0;
        for (String[] row : data) {
            if (row.length > 0 && row[0] != null) {
                max = Math.max(max, row[0].length());
            }
        }
        return max;
    }
}

关键改进说明:

  • 语义化初始化:使用静态初始化块 {"Mexico", "DF"}, ... 替代冗长的逐项赋值,代码更简洁易读;
  • 职责分离:maxPadding() 负责计算列宽,generateTable() 专注格式化输出,符合单一职责原则;
  • 现代语法优化:Java 11+ 支持 String::repeat(),替代手动 StringBuilder 拼接空格,大幅提升可读性与健壮性;
  • 表头对齐处理:显式计算 "Country" 字符串与最长国家名的长度差,确保表头列与数据列视觉对齐;
  • 防御性编程:maxPadding() 中加入 row[0] != null 判断,避免潜在 NullPointerException。

⚠️ 注意事项:

  • 若数据含超长字符串(如 "Côte d'Ivoire"),建议限制最大列宽或启用自动换行(需更复杂布局逻辑);
  • 此方案适用于纯文本终端输出;若需生成 Excel 或 HTML 表格,应转向专用库(如 Apache POI、Thymeleaf);
  • 实际项目中,推荐用 Map 或自定义 Country 类替代二维数组,提升类型安全与可扩展性。

掌握这种“数据存储 + 格式化渲染”分离的思想,是你从数组练习迈向真实 Java 应用开发的重要一步。