Java 使用 JXL 動態計算 Excel 欄寬完美適配中文報表

JXL 無自動欄寬功能的替代方案

JXL (jxl.jar) 不支援 autoSizeColumn，針對以中文為主的報表，可統計每欄最大字元寬度（中文佔 2 個字元單位），手動設定欄寬達到近似自適應效果。

核心演算法邏輯

1. 中文字符 Unicode 範圍 \u4e00-\u9fa5，每字佔 2 寬度單位。
2. 英文、數字、符號各佔 1 單位（近似）。
3. 遍歷所有資料列，記錄每欄最大寬度值。
4. 寫入資料後，一次性呼叫 sheet.setColumnView(colIndex, width) 設定。

完整實作代碼

import java.io.File;
import java.util.*;
import java.util.regex.*;
import jxl.Workbook;
import jxl.write.*;

public class ExcelBestColumn {
    public static void main(String[] args) throws Exception {
        // 模擬資料：兩列兩行
        List<String> row1 = Arrays.asList("最適合列寬", "這個基本可以實現");
        List<String> row2 = Arrays.asList("Best Column Width", "Haha");
        List<List<String>> data = Arrays.asList(row1, row2);

        WritableWorkbook book = Workbook.createWorkbook(new File("t.xls"));
        WritableSheet sheet = book.createSheet("測試", 0);
        writeDataToSheet(sheet, data);
        book.write();
        book.close();
    }

    public static void writeDataToSheet(WritableSheet sheet, List<List<String>> data) throws Exception {
        int colCount = data.get(0).size();
        int[] bestWidth = new int[colCount]; // 記錄各欄最大寬度

        // 寫入資料並同步統計寬度
        for (int i = 0; i < data.size(); i++) {
            List<String> row = data.get(i);
            for (int j = 0; j < row.size(); j++) {
                String cell = row.get(j);
                sheet.addCell(new Label(j, i, cell));
                
                // 計算顯示寬度：中文算 2，其他算 1
                int width = cell.length() + getChineseCount(cell);
                if (bestWidth[j] < width) bestWidth[j] = width;
            }
        }

        // 套用欄寬
        for (int i = 0; i < bestWidth.length; i++) {
            sheet.setColumnView(i, bestWidth[i]);
        }
    }

    /** 統計字串中中文字符數量 */
    public static int getChineseCount(String str) {
        int count = 0;
        Pattern p = Pattern.compile("[\u4e00-\u9fa5]");
        Matcher m = p.matcher(str);
        while (m.find()) count++;
        return count;
    }
}

適用性與限制分析

進階改進建議

• 若需精準像素級控制，建議遷移至 Apache POI (SXSSF) 支援 autoSizeColumn 並可獲取字體度量資訊。
• 可引入字體度量庫 (如 java.awt.FontMetrics) 計算實際像素寬度，再換算為 JXL 寬度單位 (1/256 字符寬度)。
• 對於固定格式報表，預先定義欄寬常數表，避免運行時統計開銷。

Maven 依賴

<dependency>
    <groupId>net.sourceforge.jexcelapi</groupId>
    <artifactId>jxl</artifactId>
    <version>2.6.12</version>
</dependency>