国产化Excel处理组件Spire.XLS教程：Java 向 Excel 写入数据的3种高效方法（含代码示例）-牛翰网

手动向 Excel 工作表中输入数据既耗时又容易出错，尤其是在处理大型数据集时。而借助合适的 Java Excel 库，可以简化数据输入这一流程。

E-iceblue旗下Spire系列产品，是文档处理领域的佼佼者，支持国产化信创。本文将详细介绍如何使用 Spire.XLS for Java 库，通过 3 种高效方法完成 Java 向 Excel 工作表的数据写入，涵盖基础的逐个单元格录入、批量数组插入以及 DataTable 导出。

Spire.XLS for Java免费试用下载，请联系E-iceblue官方授权代理商慧都科技

加入Spire技术交流QQ群（125237868），与更多开发者一起提升文档开发技能。

设置与安装

开始之前，需先将 Spire.XLS for Java 集成到项目中，以下为两种快速部署方式：

方式 1：手动下载 JAR 包

访问 Spire.XLS for Java 官方下载页面
下载最新版本的 JAR 文件
将 JAR 文件手动导入项目中

Spire.XLS for Java免费试用下载，请联系E-iceblue官方授权代理商慧都科技

加入Spire技术交流QQ群（125237868），与更多开发者一起提升文档开发技能。

方式 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);
    }
}

适用场景：

适用于小型数据集，且需要精确控制单元格位置的场景（例如添加标题、单行数据录入）。

效果预览：

写入数组到 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 导入数据）。

效果预览：