如何使用Apache POI为特定列（排除D列）添加筛选功能？

问题根源 #

Apache POI的sheet.setAutoFilter()方法每次调用都会覆盖之前的筛选配置，因为它仅支持绑定单个连续单元格区域，无法直接实现非连续列的筛选需求。

解决方案（针对XSSFSheet） #

通过操作Apache POI底层的OOXML对象（CTAutoFilter和CTFilterColumn），可以手动指定需要启用筛选的非连续列：

import org.apache.poi.xssf.usermodel.XSSFSheet;
import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTAutoFilter;
import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTFilterColumn;

// 假设sheet是已初始化的XSSFSheet实例
XSSFSheet sheet = ...;

// 获取或创建CTAutoFilter对象
CTAutoFilter ctAutoFilter = sheet.getCTWorksheet().getAutoFilter();
if (ctAutoFilter == null) {
    ctAutoFilter = sheet.getCTWorksheet().addNewAutoFilter();
}

// 设置筛选的整体引用范围（需包含所有目标列，Excel要求）
ctAutoFilter.setRef("A3:H3");

// 定义需要启用筛选的列索引（A=0, B=1, C=2, E=4, F=5, G=6, H=7）
int[] targetColumns = {0, 1, 2, 4, 5, 6, 7};
for (int colIdx : targetColumns) {
    CTFilterColumn filterCol = ctAutoFilter.addNewFilterColumn();
    filterCol.setColId(colIdx);
    filterCol.addNewFilters(); // 必须添加该节点，否则Excel不显示筛选按钮
}

关键说明 #

1. 整体引用范围：必须通过ctAutoFilter.setRef()指定一个包含所有目标列的连续范围（比如A3:H3），这是Excel识别筛选区域的必要条件。
2. 列索引对应关系：POI中列索引从0开始，A列对应0，B列对应1，以此类推。
3. Filters节点：每个CTFilterColumn必须调用addNewFilters()，否则Excel打开文件后不会显示对应列的筛选按钮。

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