如何用Apache POI与Java设置Word嵌套表格的列宽？

你的代码问题出在这几个核心点：

• 重复调用addNewTcPr()，生成多个<w:tcPr>节点，Word只会识别第一个，导致后续宽度设置失效
• 只设置单元格宽度，但未给嵌套表格定义表格网格（CTTblGrid），Word表格的列宽依赖网格定义来约束
• 没有指定宽度单位（比如DXA，Word的最小宽度单位，1DXA≈0.05磅）

修正步骤： #

1. 给嵌套表格开启固定列宽模式，关闭自动调整
2. 创建表格网格，预先定义每一列的默认宽度
3. 遍历单元格时复用已有TcPr节点，避免重复创建，同时指定宽度单位

完整代码示例： #

// 1. 设置嵌套表格为固定列宽模式，禁止自动调整
nestedtable.getCTTbl().addNewTblPr().addNewTblLayout().setType(STTblLayoutType.FIXED);

// 2. 创建表格网格，定义每一列的宽度（替换成你嵌套表格的实际列数）
int columnCount = 2; // 改成你的嵌套表格列数
CTTblGrid tblGrid = nestedtable.getCTTbl().addNewTblGrid();
for (int i = 0; i < columnCount; i++) {
    CTTblGridCol gridCol = tblGrid.addNewGridCol();
    gridCol.setW(BigInteger.valueOf(400)); // 设置列宽为400DXA
}

// 3. 遍历单元格设置宽度，复用已有TcPr节点
for (int i = 0; i < nestedtable.getNumberOfRows(); i++) {
    XWPFTableRow row = nestedtable.getRow(i);
    List<XWPFTableCell> cells = row.getTableCells();
    for (int j = 0; j < cells.size(); j++) {
        XWPFTableCell cell = cells.get(j);
        CTTc cttc = cell.getCTTc();
        // 获取已有的TcPr，没有则创建
        CTTcPr tcPr = cttc.isSetTcPr() ? cttc.getTcPr() : cttc.addNewTcPr();
        
        // 设置单元格宽度并指定单位为DXA
        CTTblWidth tcWidth = tcPr.isSetTcW() ? tcPr.getTcW() : tcPr.addNewTcW();
        tcWidth.setW(BigInteger.valueOf(400));
        tcWidth.setType(STTblWidth.DXA);
        
        // 可选：保留不自动换行设置
        if (!tcPr.isSetNoWrap()) {
            tcPr.addNewNoWrap();
        }
    }
}

关键说明： #

• STTblLayoutType.FIXED：强制表格使用固定列宽，避免Word自动压缩列宽
• CTTblGrid：这是Word识别列宽的核心，没有网格定义的话，单元格宽度设置大概率失效
• 指定DXA单位：如果不明确单位，Word会默认用百分比或自动调整，导致宽度不符合预期

这样设置后，嵌套表格的列宽会按指定数值显示，无需手动调整。

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