手动向 Excel 工作表中输入数据既耗时又容易出错，尤其是在处理大型数据集时。而借助合适的 Java Excel 库，可以简化数据输入这一流程。本文将详细介绍如何使用 Spire.XLS for Java 库，通过 3 种高效方法完成 Java 向 Excel 工作表的数据写入，涵盖基础的逐个单元格录入、批量数组插入以及 DataTable 导出。
设置与安装
开始之前，需先将 Spire.XLS for Java 集成到项目中，以下为两种快速部署方式：
方式 1：手动下载 JAR 包
- 访问 Spire.XLS for Java 官方下载页面
- 下载最新版本的 JAR 文件
- 将 JAR 文件手动导入项目中
方式 2：Maven 依赖集成
在项目 pom.xml 中添加以下仓库和依赖，Maven 会自动下载并引入库（无需手动处理依赖冲突）：
<repositories>
<repository>
<id>com.e-iceblue</id>
<name>e-iceblue</name>
<url>https://repo.e-iceblue.cn/repository/maven-public/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>e-iceblue</groupId>
<artifactId>spire.xls</artifactId>
<version>15.8.3</version>
</dependency>
</dependencies>
Java 向 Excel 中写入数据的 3 种方法
Spire.XLS for Java 提供了灵活的数据写入方法，可适配不同使用场景。以下将结合完整代码示例、说明及适用场景，逐一介绍每种方法。
1. 在 Excel 单元格中写入文本或数字
若需向单个单元格填充文本或数字，Spire.XLS 支持通过行、列索引（例如(2,1)代表第 2 行第 1 列）或 Excel 样式引用（例如"A1"、"B3"）直接定位目标单元格：
核心方法：
- 使用
Worksheet.get(int row, int column)或Worksheet.get(String name)方法获取指定 Excel 单元格 - 使用
setValue()方法向单元格写入文本值 - 使用
setNumberValue()方法向单元格写入数值
Java 代码示例：
import com.spire.xls.*;
public class WriteToCells {
public static void main(String[] args) {
// 创建 Workbook 对象
Workbook workbook = new Workbook();
// 获取第一个工作表
Worksheet worksheet = workbook.getWorksheets().get(0);
// 向指定单元格写入数据
worksheet.get("A1").setValue("物品名");
worksheet.get("B1").setValue("数量");
worksheet.get("C1").setValue("分类");
worksheet.get("D1").setValue("采购日期");
worksheet.get(2,1).setValue("键盘");
worksheet.get(2,2).setNumberValue(12);
worksheet.get(2,3).setValue("办公用品");
worksheet.get(2,4).setValue("2024/11/09");
worksheet.get(3,1).setValue("毛巾");
worksheet.get(3,2).setNumberValue(30);
worksheet.get(3,3).setValue("生活用品");
worksheet.get(3,4).setValue("2024/12/18");
// 为第一行应用样式
CellStyle style = workbook.getStyles().addStyle("newStyle");
style.getFont().isBold(true); // 设置字体为粗体
worksheet.getRange().get(1,1,1,4).setStyle(style);
// 保存为 Excel 文件
workbook.saveToFile("写入数据到单元格.xlsx", ExcelVersion.Version2016);
}
}
适用场景：
适用于小型数据集，且需要精确控制单元格位置的场景（例如添加标题、单行数据录入）。
效果预览：
2. 写入数组到 Excel 工作表
将一维数组（单行）或二维数组（多行多列）一次性插入连续单元格区域，能提升逐个写入的效率。
核心 API：insertArray() 解析
insertArray() 方法可轻松处理一维数组（单行数据）和二维数组（多行多列数据），其参数说明如下：
Object[] array/ Object[][] array：待插入的一维、二维数组int firstRow：起始行索引（从 1 开始）int firstColumn：起始列索引（从 1 开始）boolean isVertical：一维数组插入方向false：水平插入（从左到右）true：垂直插入（从上到下）
Java 代码示例：
import com.spire.xls.*;
public class WriteArrayToWorksheet {
public static void main(String[] args) {
// 创建 Workbook 实例
Workbook workbook = new Workbook();
// 获取第一个工作表
Worksheet worksheet = workbook.getWorksheets().get(0);
// 创建一维数组
Object[] oneDimensionalArray = {"一月", "二月", "三月", "四月", "五月", "六月"};
// 将一维数组写入工作表第一行
worksheet.insertArray(oneDimensionalArray, 1, 1, false);
// 创建二维数组
Object[][] twoDimensionalArray = {
{"姓名", "年龄", "性别", "部门", "电话"},
{"Bob", "25", "男", "技术部", "654214"},
{"John", "24", "男", "广告部", "624847"},
{"Kelly", "26", "女", "销售部", "624758"}
};
// 将二维数组从 A3 单元格开始写入工作表
worksheet.insertArray(twoDimensionalArray, 3, 1);
// 为第一行和第三行应用样式
CellStyle style = workbook.getStyles().addStyle("newStyle");
style.getFont().isBold(true); // 设置字体为粗体
worksheet.getRange().get(1,1,1,6).setStyle(style);
worksheet.getRange().get(3,1,3,6).setStyle(style);
// 保存为 Excel 文件
workbook.saveToFile("写入数组.xlsx", ExcelVersion.Version2016);
}
}
适用场景：
适用于有序数据（例如库存日志、用户列表）的批量插入场景。
效果预览：
3. 写入 DataTable 数据到 Excel 工作表
若数据存储在 DataTable 中（例如来自数据库的数据），Spire.XLS 可通过 insertDataTable() 方法直接将其导出到 Excel，并保留数据结构和列标题。
核心 API：insertDataTable() 解析
insertDataTable() 是专用于向 Excel 工作表中批量插入结构化数据集的方法，其参数说明如下：
DataTable dataTable：待导出的 DataTable 对象boolean columnHeaders：是否将 DataTable 的列名作为 Excel 表头int firstRow：起始行索引（从 1 开始）int firstColumn：起始列索引（从 1 开始）boolean transTypes：是否保留数据类型
Java 代码示例：
import com.spire.xls.*;
import com.spire.xls.data.table.DataRow;
import com.spire.xls.data.table.DataTable;
public class WriteDataTableToWorksheet {
public static void main(String[] args) throws Exception {
// 创建 Workbook 实例
Workbook workbook = new Workbook();
// 获取第一个工作表
Worksheet worksheet = workbook.getWorksheets().get(0);
// 创建 DataTable 对象
DataTable dataTable = new DataTable();
dataTable.getColumns().add("SKU", Integer.class); // 库存单位（SKU）
dataTable.getColumns().add("产品名", String.class); // 产品名称
dataTable.getColumns().add("价格", String.class); // 价格
// 创建数据行并添加数据
DataRow dr = dataTable.newRow();
dr.setInt(0, 512900512);
dr.setString(1,"无线鼠标M200");
dr.setString(2,"￥99");
dataTable.getRows().add(dr);
dr = dataTable.newRow();
dr.setInt(0,512900637);
dr.setString(1,"B100有线鼠标");
dr.setString(2,"￥85");
dataTable.getRows().add(dr);
dr = dataTable.newRow();
dr.setInt(0,512901829);
dr.setString(1,"游戏鼠标");
dr.setString(2,"￥125");
dataTable.getRows().add(dr);
dr = dataTable.newRow();
dr.setInt(0,512900386);
dr.setString(1,"ZM光电鼠标");
dr.setString(2,"￥89");
dataTable.getRows().add(dr);
// 将DataTable写入工作表
worksheet.insertDataTable(dataTable,true,1,1,true);
// 为第一行应用样式
CellStyle style = workbook.getStyles().addStyle("newStyle");
style.getFont().isBold(true); // 设置字体为粗体
worksheet.getRange().get(1,1,1,3).setStyle(style);
// 保存为Excel文件
workbook.saveToFile("写入DataTable.xlsx", ExcelVersion.Version2016);
}
}
适用场景：
适用于导出数据库数据、客户关系管理（CRM）数据，或任何存储在 DataTable 中的结构化数据（例如 SQL 查询结果、CSV 导入数据）。
效果预览：
大型数据集性能优化指南
当处理超大型数据时，需通过以下手段减少内存占用、提升速度：
- 优先使用批量操作（
insertArray()或insertDataTable()），而非逐个单元格写入。 - 先写入所有数据，最后统一设置样式（避免频繁刷新表格布局）。
- 对于大型数据集，建议使用流模式写入以减少内存占用。
常见问题（FAQ）
Q1：Spire.XLS for Java 支持哪些 Excel 格式？
答：Spire.XLS for Java 支持所有主流 Excel 格式，包括：
- 旧版：XLS（Excel 97-2003）
- 新版：XLSX、XLSM（支持宏）、XLSB 等。
可通过 saveToFile() 方法指定输出格式。
Q2：如何设置单元格格式（颜色、字体、边框）？
答：Spire.XLS 提供了丰富的样式设置功能，可参考以下指南：
Q3：如何消除输出文件中的 Evaluation Warning？
答：需申请免费试用许可证，步骤如下：
- 访问 Spire.XLS 免费试用申请页，填写信息获取 30 天试用密钥；
- 在创建 Workbook 前添加许可证代码（须放在最前面）：
com.spire.xls.license.LicenseProvider.setLicenseKey("许可证密钥");
Workbook workbook = new Workbook();
总结
对于数据驱动应用中的 Java 开发者而言，掌握 Excel 导出功能至关重要。Spire.XLS for Java 库提供了 3 种通过 Java 向 Excel 写入数据的高效方法：
- 逐个单元格写入：实现精确控制
- 数组批量插入：实现高性能数据录入
- DataTable 导出：实现数据库式结构化数据传输
结合本文的性能优化技巧，可轻松应对从简单报表到大型数据导出的各类需求。若需进一步探索高级功能（如公式计算、图表插入），可参考 Spire.XLS 官网的教程示例。
