Java 中使用二维数组格式化输出表格数据的完整教程_技术教程

本文讲解如何用 java 二维数组构建结构化表格（如国家与首都对照表），重点解决列对齐问题——通过动态计算最大列宽、手动补空格实现美观排版，并倡导模块化编码实践。

在 Java 初学阶段，用二维数组模拟简单表格（如国家-首都映射）是非常实用的练习。但直接使用 System.out.println() 逐行打印会导致列无法对齐，视觉混乱。核心挑战在于：不同国家名称长度差异大（如 "Mexico" vs "Guatemala"），需为短文本右侧补充空格，使所有首列内容右边界统一。

下面是一个专业、可复用的解决方案，遵循“单一职责”原则，将逻辑拆分为清晰的辅助方法：

✅ 正确实现：动态列宽 + 模块化设计

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 - "Country".length()
        System.out.printf("Country%sCapital%n", addPadding("Country", padding));
        for (String[] row : data) {
            System.out.printf("%s%s%s%n", row[0], addPadding(row[0], padding), row[1]);
        }
    }

    /**
     * 计算首列（国家名）的最大字符长度
     */
    private static int maxPadding(String[][] data) {
        int max = 0;
        for (String[] row : data) {
            if (row[0].length() > max) {
                max = row[0].length();
            }
        }
        return max;
    }

    /**
     * 为指定字符串生成所需空格（使总宽度达到 padding）
     * 例如：country="Mexico"(6), padding=11 → 返回 5 个空格
     */
    private static String addPadding(String country, int padding) {
        int spacesNeeded = padding - country.length();
        return " ".repeat(Math.max(0, spacesNeeded)); // Java 11+ 推荐写法
        // 兼容旧版本可替换为：new String(new char[spacesNeeded]).replace('\0', ' ');
    }
}

? 关键要点说明

printf 与格式化占位符：%s 插入字符串，%n 是平台无关换行符（优于 \n）；
动态空格计算：addPadding() 精确控制每行首列末尾空格数，确保第二列垂直对齐；
标题对齐一致性：标题 "Country" 也参与 padding 计算（即 addPadding("Country", padding)），避免表头错位；
代码可维护性：分离 maxPadding（数据分析）、addPadding（格式处理）、generateTable（展示逻辑），便于调试和复用；
现代 Java 提示："
".repeat(n) 是 Java 11 引入的简洁空格生成方式，若使用低版本请改用 StringBuilder 循环追加。