Java导出xls文件通常借助Apache POI库实现，核心流程包括创建HSSFWorkbook对象、添加Sheet工作表、遍历数据填充Row行与Cell单元格，可设置字体、颜色等样式增强可读性，最后通过ServletOutputStream或FileOutputStream输出至客户端或本地，需注意大数据量场景下使用SXSSFWorkbook（基于流式处理）避免内存溢出，同时处理异常（如文件关闭、流释放），常见应用场景包括系统数据报表导出、Excel模板填充等，操作时需注意兼容性（如.xls格式最大行数限制）及样式细节优化，确保导出文件符合业务需求。
Java实现Excel XLS文件导出的完整指南
在Java开发中，将数据导出为Excel文件是常见需求，尤其在报表生成、数据备份、数据迁移等场景中，XLS作为Excel的传统文件格式（基于BIFF二进制交换文件结构），凭借其广泛的兼容性，至今仍被众多企业系统广泛采用，本文将详细介绍如何使用Java实现XLS文件的导出，包括核心库选择、代码实现、常见问题处理及高级技巧。
为什么选择XLS格式？
虽然Excel新版推荐使用XLSX格式（基于XML）,但XLS格式在特定场景下仍具有不可替代的优势：
- 兼容性强：能被Excel 97及以上版本完美打开，无需担心版本兼容问题,特别适合需要与旧系统交互的场景；
- 体积小：对于结构简单的数据，XLS文件体积通常小于XLSX,在网络传输和存储方面有优势；
- 老旧系统支持：部分企业内部系统仍依赖XLS格式进行数据交互，如ERP系统、财务软件等；
- 处理速度快：对于小规模数据,XLS格式的读写性能通常优于XLSX。
核心工具选择：Apache POI
在处理Excel文件导出的Java库中，Apache POI是最主流的选择，它提供了一套完整的API来操作Office文档，其中针对XLS格式的核心类是HSSFWorkbook（表示整个Excel工作簿），除了Apache POI，还有其他可选库如JXL、EasyExcel等，但POI功能最全面,社区支持最好。
Maven依赖
在项目中引入POI的XLS相关依赖（注意：POI 5.x版本已将poi和poi-ooxml合并，但XLS操作仍需poi核心包）：
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.3</version>
</dependency>
对于需要同时支持XLS和XLSX的项目,建议添加完整依赖：
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi</artifactId>
<version>5.2.3</version>
</dependency>
<dependency>
<groupId>org.apache.poi</groupId>
<artifactId>poi-ooxml</artifactId>
<version>5.2.3</version>
</dependency>
XLS导出基本实现步骤
使用POI导出XLS文件的核心流程可概括为：创建工作簿 → 创建工作表 → 创建行/单元格 → 写入数据 → 输出文件,以下是详细步骤及代码示例。
创建工作簿（HSSFWorkbook）
HSSFWorkbook是XLS文件的根对象,代表一个Excel工作簿。
HSSFWorkbook workbook = new HSSFWorkbook();
创建工作表（HSSFSheet）
工作簿中可包含多个工作表，通过createSheet()方法创建,参数为工作表名称。
HSSFSheet sheet = workbook.createSheet("用户数据");
设置列宽（可选）
默认列宽较窄，可通过setColumnWidth()方法调整，参数为列索引（从0开始）和宽度（单位：1/256字符宽度）。
sheet.setColumnWidth(0, 20 * 256); // 第1列宽度为20个字符 sheet.setColumnWidth(1, 15 * 256); // 第2列宽度为15个字符
创建表头（HSSFRow）
表头通常位于第一行，通过createRow()方法创建行，参数为行索引（从0开始），再用createCell()创建单元格并设置值。
// 创建表头行
HSSFRow headerRow = sheet.createRow(0);
// 设置表头单元格
headerRow.createCell(0).setCellValue("ID");
headerRow.createCell(1).setCellValue("姓名");
headerRow.createCell(2).setCellValue("年龄");
headerRow.createCell(3).setCellValue("邮箱");
写入数据行（HSSFRow）
根据业务数据循环创建数据行，填充单元格值，数据可以是字符串、数字、日期等类型。
// 模拟业务数据
List<User> userList = Arrays.asList(
new User(1, "张三", 25, "zhangsan@example.com"),
new User(2, "李四", 30, "lisi@example.com"),
new User(3, "王五", 28, "wangwu@example.com")
);
// 写入数据行
for (int i = 0; i < userList.size(); i++) {
User user = userList.get(i);
HSSFRow dataRow = sheet.createRow(i + 1); // 从第2行开始（表头占第1行）
dataRow.createCell(0).setCellValue(user.getId());
dataRow.createCell(1).setCellValue(user.getName());
dataRow.createCell(2).setCellValue(user.getAge());
dataRow.createCell(3).setCellValue(user.getEmail());
}
输出文件（FileOutputStream）
将工作簿写入输出流，生成XLS文件，需注意关闭资源,避免文件泄漏。
try (FileOutputStream out = new FileOutputStream("user_data.xls")) {
workbook.write(out);
System.out.println("XLS文件导出成功！");
} catch (IOException e) {
System.err.println("XLS文件导出失败：" + e.getMessage());
} finally {
try {
workbook.close(); // 关闭工作簿
} catch (IOException e) {
e.printStackTrace();
}
}
完整代码示例
import org.apache.poi.hssf.usermodel.HSSFRow;
import org.apache.poi.hssf.usermodel.HSSFSheet;
import org.apache.poi.hssf.usermodel.HSSFWorkbook;
import java.io.FileOutputStream;
import java.io.IOException;
import java.util.Arrays;
import java.util.List;
public class XlsExportExample {
// 用户实体类
static class User {
private int id;
private String name;
private int age;
private String email;
public User(int id, String name, int age, String email) {
this.id = id;
this.name = name;
this.age = age;
this.email = email;
}
// Getter方法
public int getId() { return id; }
public String getName() { return name; }
public int getAge() { return age; }
public String getEmail() { return email; }
}
public static void main(String[] args) {
try {
// 1. 创建工作簿
HSSFWorkbook workbook = new HSSFWorkbook();
// 2. 创建工作表
HSSFSheet sheet = workbook.createSheet("用户数据");
// 3. 设置列宽
sheet.setColumnWidth(0, 20 * 256); // ID列
sheet.setColumnWidth(1, 15 * 256); // 姓名列
sheet.setColumnWidth(2, 10 * 256); // 年龄列
sheet.setColumnWidth(3, 25 * 256); // 邮箱列
// 4. 创建表头
HSSFRow headerRow = sheet.createRow(0);
headerRow.createCell(0).setCellValue("ID");
headerRow.createCell(1).setCellValue("姓名");
headerRow.createCell(2).setCellValue("年龄");
headerRow.createCell(3).setCellValue("邮箱");
// 5. 准备数据
List<User> userList = Arrays.asList(
new User(1, "张三", 25, "zhangsan@example.com"),
new User(2, "李四", 30, "lisi@example.com"),
