使用Apache POI写入数字字符串时消除Excel“以文本形式存储数字”警告

问题 #

开发Java项目时，使用Apache POI生成Excel文件，其中账号列虽为数字内容，但需以字符串形式存储。目前遇到的问题是：打开生成的Excel时，该列单元格会显示“以文本形式存储数字”的警告。

已尝试方案 #

• 使用Apache POI的DataFormat类将单元格格式设置为文本（@）；
• 在值前添加单引号，但单引号会在Excel中直接显示，不符合需求；
• 显式设置单元格样式为文本，且确认值已以字符串写入，但警告仍存在。

期望结果 #

• 账号在Excel中保持字符串形式（而非数字类型）；
• 打开Excel时不显示“以文本形式存储数字”类警告。

现有代码 #

public class ExcelWriter {

 public static void main(String[] args) {
     // 定义文件名
     String fileName = "EmployeeDetails.xlsx";

     // 创建工作簿
     Workbook workbook = new XSSFWorkbook();

     // 创建工作表
     Sheet sheet = workbook.createSheet("Employee Data");

     // 定义表头
     String[] headers = {"Serial Number", "Employee Name", "Account Number", "Number"};

     // 创建表头行
     Row headerRow = sheet.createRow(0);
     CellStyle headerStyle = workbook.createCellStyle();
     // ...现有代码...

     // 创建文本格式的单元格样式
     CellStyle textStyle = workbook.createCellStyle();
     DataFormat format = workbook.createDataFormat();
     textStyle.setDataFormat(format.getFormat("@"));

     // 示例数据
     Object[][] data = {
         {1, "John Doe", "123456789", 1000},
         {2, "Jane Smith", "987654321", 2000}
     };

     // 填充数据
     int rowNum = 1;
     for (Object[] rowData : data) {
         Row row = sheet.createRow(rowNum++);
         for (int colNum = 0; colNum < rowData.length; colNum++) {
             Cell cell = row.createCell(colNum);
             if (colNum == 2) { // 账号列
                 cell.setCellStyle(textStyle);
                 cell.setCellValue(rowData[colNum].toString());
             } else {
                 if (rowData[colNum] instanceof String) {
                     cell.setCellValue((String) rowData[colNum]);
                 } else if (rowData[colNum] instanceof Integer) {
                     cell.setCellValue((Integer) rowData[colNum]);
                 }
             }
         }
     }

     // 写入文件
     try (FileOutputStream fileOut = new FileOutputStream(fileName)) {
         workbook.write(fileOut);
     } catch (IOException e) {
         e.printStackTrace();
     }
 }
}

解决方案 #

问题核心在于：仅设置文本样式不足以让Excel完全认可单元格为纯字符串类型，需明确指定单元格类型为字符串，并调整样式与值的设置顺序，同时规避POI的格式缓存问题。

修改要点 #

1. 先设置单元格类型为STRING，再配置样式和值；
2. 使用cell.setCellType(CellType.STRING)强制指定单元格类型；
3. 确保文本样式的格式ID正确生效，避免被POI的默认格式覆盖。

修改后的代码 #

public class ExcelWriter {

 public static void main(String[] args) {
     String fileName = "EmployeeDetails.xlsx";
     Workbook workbook = new XSSFWorkbook();
     Sheet sheet = workbook.createSheet("Employee Data");

     String[] headers = {"Serial Number", "Employee Name", "Account Number", "Number"};
     Row headerRow = sheet.createRow(0);
     CellStyle headerStyle = workbook.createCellStyle();
     // ...现有表头样式代码...

     // 创建文本格式样式
     CellStyle textStyle = workbook.createCellStyle();
     DataFormat format = workbook.createDataFormat();
     textStyle.setDataFormat(format.getFormat("@"));

     Object[][] data = {
         {1, "John Doe", "123456789", 1000},
         {2, "Jane Smith", "987654321", 2000}
     };

     int rowNum = 1;
     for (Object[] rowData : data) {
         Row row = sheet.createRow(rowNum++);
         for (int colNum = 0; colNum < rowData.length; colNum++) {
             Cell cell = row.createCell(colNum);
             if (colNum == 2) { // 账号列处理
                 // 第一步：强制设置单元格类型为字符串
                 cell.setCellType(CellType.STRING);
                 // 第二步：应用文本样式
                 cell.setCellStyle(textStyle);
                 // 第三步：写入字符串值
                 cell.setCellValue(rowData[colNum].toString());
             } else {
                 if (rowData[colNum] instanceof String) {
                     cell.setCellValue((String) rowData[colNum]);
                 } else if (rowData[colNum] instanceof Integer) {
                     cell.setCellValue((Integer) rowData[colNum]);
                 }
             }
         }
     }

     try (FileOutputStream fileOut = new FileOutputStream(fileName)) {
         workbook.write(fileOut);
     } catch (IOException e) {
         e.printStackTrace();
     }
 }
}

额外说明 #

若上述修改仍无效，可尝试：

• 针对XSSFWorkbook，直接使用XSSFCell.setCellValue(String value)方法，该方法会自动适配字符串类型的存储逻辑；
• 检查代码中是否存在样式覆盖问题，确保文本样式未被后续代码重置；
• 升级Apache POI版本至4.1.2及以上，旧版本存在部分格式处理的Bug。

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