使用Apache POI 3.9（Java 8）创建PPT表格时幻灯片仅显示小黑块

嘿，我碰到过不少用POI 3.9做PPT表格踩坑的情况，你说的右上角小黑块大概率是因为表格的尺寸没正确设置，或者单元格没填充内容/指定行高列宽——毕竟POI 3.9对PPT表格的支持还比较基础，不像新版本那样能自动适配内容，必须手动把参数都配置到位才行。

核心问题分析 #

那个小黑块其实是POI生成的表格「占位符」：默认情况下，POI 3.9创建的表格宽高、行高列宽几乎都为0，没有内容的话，PPT就只能渲染出一个极小的块。

具体修复步骤 #

先假设你的基础代码大概是这类常见的缺失版本：

XMLSlideShow slideShow = new XMLSlideShow();
XSLFSlide slide = slideShow.createSlide();

// 创建表格但没设置关键参数
XSLFTable table = slide.createTable();
XSLFTableRow row = table.addRow();
XSLFTableCell cell = row.addCell();
cell.setText("测试内容");

按照下面的步骤修改就能解决问题：

1. 手动设置表格的整体位置和宽高 #

POI 3.9不会自动计算表格大小，必须通过setAnchor指定它在幻灯片上的坐标和尺寸（单位是像素）：

// （x坐标, y坐标, 宽度, 高度），根据自己需求调整数值
table.setAnchor(new Rectangle(100, 100, 600, 300));

2. 给行列指定具体的宽高 #

默认的行高、列宽接近0，必须手动赋值：

// 比如设置3列，每列200像素宽
table.setColumnWidth(0, 200);
table.setColumnWidth(1, 200);
table.setColumnWidth(2, 200);

// 给每行设置行高，比如50像素
XSLFTableRow row = table.addRow();
row.setHeight(50);

3. 确保单元格有内容，可选添加边框让表格更明显 #

空单元格也可能导致显示异常，加上边框能让表格结构更清晰：

XSLFTableCell cell = row.addCell();
cell.setText("第一行第一列");
// 设置单元格边框，可选但建议加上
cell.setBorderBottom(BorderStyle.THIN);
cell.setBorderTop(BorderStyle.THIN);
cell.setBorderLeft(BorderStyle.THIN);
cell.setBorderRight(BorderStyle.THIN);

完整可运行示例代码 #

import org.apache.poi.sl.usermodel.*;
import org.apache.poi.xslf.usermodel.*;

import java.io.FileOutputStream;
import java.awt.Rectangle;

public class PptTableTest {
    public static void main(String[] args) throws Exception {
        XMLSlideShow slideShow = new XMLSlideShow();
        XSLFSlide slide = slideShow.createSlide();

        // 创建表格并设置位置和整体大小
        XSLFTable table = slide.createTable();
        table.setAnchor(new Rectangle(100, 100, 600, 300));

        // 设置列宽
        int columnCount = 3;
        int columnWidth = 200;
        for (int i = 0; i < columnCount; i++) {
            table.setColumnWidth(i, columnWidth);
        }

        // 创建3行数据并设置行高、单元格内容和边框
        for (int rowIdx = 0; rowIdx < 3; rowIdx++) {
            XSLFTableRow row = table.addRow();
            row.setHeight(50);
            for (int colIdx = 0; colIdx < columnCount; colIdx++) {
                XSLFTableCell cell = row.addCell();
                cell.setText(String.format("第%d行第%d列", rowIdx+1, colIdx+1));
                // 给单元格加边框
                cell.setBorderBottom(BorderStyle.THIN);
                cell.setBorderTop(BorderStyle.THIN);
                cell.setBorderLeft(BorderStyle.THIN);
                cell.setBorderRight(BorderStyle.THIN);
            }
        }

        // 写入文件
        try (FileOutputStream out = new FileOutputStream("test_table.pptx")) {
            slideShow.write(out);
        }
        slideShow.close();
    }
}

额外注意事项 #

• POI 3.9对PPT表格的支持有限，别尝试用高版本的自动适配API，老老实实手动指定所有尺寸参数。
• 确保你的poi和poi-ooxml依赖都是3.9版本，别混合其他版本的POI包，避免兼容性问题。

内容的提问来源于stack exchange，提问作者Silmarillion