当前位置:

首页 > 编程开发 > 从入门到精通详解JavaApachePOI操作Excel的实战教程

从入门到精通详解JavaApachePOI操作Excel的实战教程

Java中ApachePOI库通过HSSFWorkbook和XSSFWorkbook分别支持.xls和.xlsx格式,利用Workbook、Sheet、Row、Cell等API实现文件的写入与读取。读取时需根据单元格类型(字符串、数字、日期、布尔等)使用getCellType()分支处理,并调用对应类型获取方法,避免类型转换错误。写入时通过createRow

本文目录

    一、Excel操作方式概述

    在Ja va开发里操作Excel文件,主流方案无非两条路:

    1. Apache POI——Apache基金会的老牌开源项目,专治Microsoft Office格式文件,Excel自然不在话下。
    2. EasyExcel——阿里巴巴开源的轻量级框架,本质是对POI的封装,把繁琐操作简化了不少。

    这次我们重点啃下Apache POI这块硬骨头,手把手带你掌握Ja va操作Excel的核心技能。

    二、Ja va基础IO流操作Excel的局限性

    很多人一开始会想:直接用Ja va的IO流读写Excel行不行?答案是——行不通。用字符流去读Excel文件,读出来的要么是乱码,要么直接报错,根本拿不到表里的数据。二进制流倒是能实现文件拷贝,但想解析内容?想都别想。

    // 错误演示:用字符流读取Excel文件
    import ja va.io.FileReader;
    import ja va.io.BufferedReader;
    import ja va.io.IOException;
    
    public class WrongExcelReaderDemo {
        public static void main(String[] args) {
            // 待读取的Excel文件路径(.xls或.xlsx均可,都会报错/乱码)
            String excelFilePath = "src/test/ja va/Demo.xlsx";
            
            // 声明字符流对象
            FileReader fileReader = null;
            BufferedReader bufferedReader = null;
    
            try {
                // 1. 初始化字符流,尝试读取Excel文件
                fileReader = new FileReader(excelFilePath);
                bufferedReader = new BufferedReader(fileReader);
    
                // 2. 按行读取文件内容
                String line;
                System.out.println("尝试用字符流读取Excel文件内容:");
                while ((line = bufferedReader.readLine()) != null) {
                    // 3. 输出读取到的内容(会是乱码或无法解析的字符)
                    System.out.println(line);
                }
    
            } catch (IOException e) {
                // 捕获IO异常(可能直接抛出文件读取失败,或读取过程中报错)
                e.printStackTrace();
            } finally {
                // 4. 手动关闭流(避免资源泄露,即使读取失败也执行)
                try {
                    if (bufferedReader != null) {
                        bufferedReader.close();
                    }
                    if (fileReader != null) {
                        fileReader.close();
                    }
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
        }
    }
    

    从入门到精通详解Ja vaApachePOI操作Excel的实战教程

    说到底,直接用IO流干不了这活儿,它只适合做文件级别的搬运工。

    三、Apache POI入门

    3.1 POI简介

    Apache POI,全称Poor Obfuscation Implementation,听起来挺拗口,其实就是Apache给Ja va开发者提供的一套操作Microsoft Office文档的API。Excel、Word、PowerPoint,通通能搞定。

    3.2 Excel文件格式

    Excel分两种老式和新式格式,区别很明显:

    • .xls:Excel 2003及更早版本,最多能装65536行、256列。
    • .xlsx:Excel 2007及以后,容量猛增到1048576行、16384列。

    选哪个格式,决定了你该用POI的哪个子模块。

    3.3 导入POI依赖

    操作不同格式需要引入不同的依赖,顺手把版本也定好:

    
    
        org.apache.poi
        poi
        5.2.4
    
    
    
        org.apache.poi
        poi-ooxml
        5.2.4
    

    从入门到精通详解Ja vaApachePOI操作Excel的实战教程

    四、POI写入Excel文件

    理论说再多不如动手写个例子。下面咱们就实操一下,用POI写一个实习记录表。

    4.1 核心API说明

    • Workbook:工作簿接口,代表整个Excel文件
      • HSSFWorkbook:对应.xls格式
      • XSSFWorkbook:对应.xlsx格式
    • Sheet:工作表,一个Workbook可以包含多个Sheet
    • Row:行,一个Sheet可以包含多个Row
    • Cell:单元格,一个Row可以包含多个Cell

    4.2 写入Excel示例

    import org.apache.poi.hssf.usermodel.HSSFWorkbook;
    import org.apache.poi.ss.usermodel.*;
    import ja va.io.FileOutputStream;
    import ja va.io.IOException;
    
    // 生成实习记录Excel文件(.xls格式)
    public class Test {
        public static void main(String[] args) throws Exception {
            // 1. 创建Workbook(HSSFWorkbook对应.xls,XSSFWorkbook对应.xlsx)
            Workbook workbook = new HSSFWorkbook();
            
            // 2. 创建Sheet,命名为「实习记录」(核心修改点1)
            Sheet sheet = workbook.createSheet("实习记录");
            
            // 3. 创建表头行(第一行,索引0)
            Row headerRow = sheet.createRow(0);
            // 表头单元格:姓名、性别、工作、公司
            headerRow.createCell(0).setCellValue("姓名");
            headerRow.createCell(1).setCellValue("性别");
            headerRow.createCell(2).setCellValue("工作");
            headerRow.createCell(3).setCellValue("公司");
            
            // 4. 创建数据行(第二行,索引1),填充指定数据(核心修改点2)
            Row dataRow = sheet.createRow(1);
            dataRow.createCell(0).setCellValue("小当家");  // 姓名
            dataRow.createCell(1).setCellValue("男");      // 性别
            dataRow.createCell(2).setCellValue("后端开发");// 工作
            dataRow.createCell(3).setCellValue("xxx");     // 公司
    
            // 5. 自动调整列宽(优化显示效果)
            for (int i = 0; i < 4; i++) {
                sheet.autoSizeColumn(i);
            }
            
            // 6. 写入文件并关闭资源
            try (FileOutputStream fos = new FileOutputStream("D:\实习记录.xls")) {
                workbook.write(fos);
                System.out.println("实习记录Excel生成成功!路径:D:\实习记录.xls");
            } catch (IOException e) {
                e.printStackTrace();
            } finally {
                workbook.close();
            }
        }
    }
    

    4.3 运行结果

    跑完这段代码,D盘下就会冒出一个"实习记录.xls",打开看看:

    从入门到精通详解Ja vaApachePOI操作Excel的实战教程

    控制台可能报个日志相关的警告,别慌,那是缺少log4j依赖,不影响demo跑通。

    从入门到精通详解Ja vaApachePOI操作Excel的实战教程

    五、POI读取Excel文件

    写出来是为了读。接下来看看怎么把刚才生成的Excel数据读回Ja va中。

    5.1 基本读取示例

    import org.apache.poi.hssf.usermodel.HSSFWorkbook;
    import org.apache.poi.ss.usermodel.*;
    import ja va.io.FileInputStream;
    import ja va.io.InputStream;
    
    public class TestRead {
        public static void main(String[] args) throws Exception {
            // 获取文件的数据流(实习记录Excel路径)
            InputStream inputStream = new FileInputStream("D:\实习记录.xls");
            
            // 创建文件对象(仅支持.xls格式)
            Workbook workbook = new HSSFWorkbook(inputStream);
            
            // 获取Sheet(按索引取第一个Sheet)
            Sheet sheet = workbook.getSheetAt(0);
            
            // ========== 读取小当家的信息 ==========
            // 读取第二行(数据行,索引1):第一行是表头(索引0)
            Row dataRow = sheet.getRow(1);
            
            // 读取“姓名”列(第二行第一列,索引0)
            Cell nameCell = dataRow.getCell(0);
            String name = nameCell.getStringCellValue();
            
            // 读取“性别”列(第二行第二列,索引1)
            Cell genderCell = dataRow.getCell(1);
            String gender = genderCell.getStringCellValue();
            
            // 读取“工作”列(第二行第三列,索引2)
            Cell jobCell = dataRow.getCell(2);
            String job = jobCell.getStringCellValue();
            
            // 读取“公司”列(第二行第四列,索引3)
            Cell companyCell = dataRow.getCell(3);
            String company = companyCell.getStringCellValue();
            
            // 打印读取结果
            System.out.println("姓名:" + name);
            System.out.println("性别:" + gender);
            System.out.println("工作:" + job);
            System.out.println("公司:" + company);
            
            // 关闭流
            inputStream.close();
        }
    }
    

    5.2 运行结果

    从入门到精通详解Ja vaApachePOI操作Excel的实战教程

    5.3 处理不同类型的单元格

    实际开发里,单元格不会全是字符串——数字、日期甚至公式都有可能。如果你一股脑用getStringCellValue()去取数字单元格,程序会直接报错。所以必须根据单元格类型来做分支处理:

    import org.apache.poi.hssf.usermodel.HSSFWorkbook;
    import org.apache.poi.ss.usermodel.*;
    import ja va.io.FileInputStream;
    import ja va.io.InputStream;
    
    public class TestRead {
        public static void main(String[] args) throws Exception {
            // 获取文件的数据流(实习记录Excel路径)
            InputStream inputStream = new FileInputStream("D:\实习记录.xls");
            
            // 创建文件对象(仅支持.xls格式)
            Workbook workbook = new HSSFWorkbook(inputStream);
            
            // 获取Sheet(按索引取第一个Sheet)
            Sheet sheet = workbook.getSheetAt(0);
            
            // ========== 读取小当家的信息 ==========
            // 读取第二行(数据行,索引1):第一行是表头(索引0)
            Row dataRow = sheet.getRow(1);
            
            // 读取“姓名”列(第二行第一列,索引0)
            Cell nameCell = dataRow.getCell(0);
            String name = nameCell.getStringCellValue();
            
            // 读取“性别”列(第二行第二列,索引1)
            Cell genderCell = dataRow.getCell(1);
            String gender = genderCell.getStringCellValue();
            
            // 读取“工作”列(第二行第三列,索引2)
            Cell jobCell = dataRow.getCell(2);
            if (jobCell.getCellType() == CellType.STRING) {
                String job = jobCell.getStringCellValue();
            } else if (jobCell.getCellType() == CellType.NUMERIC) {
                double jobNum = jobCell.getNumericCellValue();
                String job = String.valueOf(jobNum);
            }
            
            // 读取“公司”列(第二行第四列,索引3)
            Cell companyCell = dataRow.getCell(3);
            if (companyCell.getCellType() == CellType.STRING) {
                String company = companyCell.getStringCellValue();
            } else if (companyCell.getCellType() == CellType.NUMERIC) {
                double companyNum = companyCell.getNumericCellValue();
                String company = String.valueOf(companyNum);
            }
            
            // 打印读取结果
            System.out.println("姓名:" + name);
            System.out.println("性别:" + gender);
            System.out.println("工作:" + job);
            System.out.println("公司:" + company);
            
            // 关闭流
            inputStream.close();
        }
    }
    

    六、总结

    走完这一趟,可以捋一下学到的东西:

    1. Ja va操作Excel有两条路:POI和EasyExcel,各有所长。
    2. 纯IO流搞不定Excel解析,别在上面浪费时间。
    3. POI的核心API:Workbook、Sheet、Row、Cell,按层级操作就好。
    4. 用POI写Excel:创建Workbook → 建Sheet → 写行/单元格 → 输出到文件。
    5. 用POI读Excel:读取流 → 解析Workbook → 遍历Sheet/Row/Cell。
    6. 读取时一定要判断单元格类型(字符串、数字、日期等),否则容易翻车。

    POI功能全面但代码量偏大,如果只是想快速处理大批量数据,EasyExcel封装得更友好。不过理解POI的底层逻辑,对日后用任何Excel工具都有帮助——毕竟,万变不离其宗。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发 Excel
    相关文章 更多
    Excel怎么跨表引用数据 引用功能与工作表链接方法
    Excel怎么跨表引用数据 引用功能与工作表链接方法

    Excel跨表引用数据,可以在目标单元格输入等号,再点击源工作表标签和需要引用的单元格,按Enter完成。公式通常是“工作表名!单元格地址”;需要向下复制时,还要检查相对引用与绝对引用是否符合需求。

    Excel如何转换文本为日期 分列功能与格式设置方法
    Excel如何转换文本为日期 分列功能与格式设置方法

    Excel把文本转换为日期,可以选中日期列,进入“数据—分列”,保持每条日期不被拆开,在最后一步选择“日期”并指定YMD、DMY或MDY顺序。完成解析后,再设置日期显示格式,并抽查年月日,不能只改显示格式就认为转换成功。

    Excel怎么批量填充序号 填充功能与序列生成解决方法
    Excel怎么批量填充序号 填充功能与序列生成解决方法

    Excel批量填充序号,可以先输入1和2,选中这两格,再拖动右下角填充柄向下延续。需要一次生成较多序号时,进入“开始—填充—序列”,选择列、等差序列、步长1,并设置终止值即可。

    Excel如何生成数据透视表 插入功能与字段拖拽方法
    Excel如何生成数据透视表 插入功能与字段拖拽方法

    Excel生成数据透视表,先选中带有字段标题的明细区域,点击“插入—数据透视表”,确认数据源并选择放置位置。创建后把分类字段拖到“行”或“列”,把金额、数量拖到“值”,再检查求和方式与汇总结果。

    Excel怎么合并多个表格 数据功能与Power Query方法
    Excel怎么合并多个表格 数据功能与Power Query方法

    Excel合并多个结构相同的表格,可以在Windows桌面版进入“数据—获取数据—从文件—从文件夹”,选择源文件夹,再用Power Query合并并转换数据。若已经把各张表建立为查询,则使用“追加查询”把记录纵向汇总,检查字段与类型后加载结果。

    Excel如何保护工作表 审阅功能与密码设置解决方法
    Excel如何保护工作表 审阅功能与密码设置解决方法

    Excel保护工作表,可以先解除需要填写区域的锁定,再点击“审阅—保护工作表”,设置取消保护密码和允许操作并确认。这样可以保留录入区域,同时限制公式、表头等单元格被随意修改;需要调整设置时,先取消工作表保护。

    Excel怎么打印每页表头 页面布局功能与打印标题方法
    Excel怎么打印每页表头 页面布局功能与打印标题方法

    Excel每页打印表头,可以进入“页面布局—打印标题”,在“工作表”页签的“顶端标题行”中选择表头所在的整行,例如第一行填写$1:$1。保存后打开打印预览,并翻到第二页确认表头已重复出现。

    Excel如何删除重复项 数据工具功能与去重解决方法
    Excel如何删除重复项 数据工具功能与去重解决方法

    Excel删除重复项,先选中完整数据区域,点击“数据—删除重复项”,确认是否包含标题,再勾选用于判断重复的列并确定。操作会删除所选区域内的重复记录,建议先备份,并用业务编号、日期等字段确定真正的重复标准。

    Excel怎么设置条件格式 突出显示功能与规则设置方法
    Excel怎么设置条件格式 突出显示功能与规则设置方法

    Excel设置条件格式,先选中数据区域,再点击“开始—条件格式—突出显示单元格规则”,选择大于、小于或重复值等条件,填写判断值并设置样式。以后需要修改范围或取消规则,可进入“管理规则”检查条件与“应用于”区域。

    Excel如何拆分单元格内容 分列功能与分隔符设置方法
    Excel如何拆分单元格内容 分列功能与分隔符设置方法

    Excel拆分单元格内容,可以选中需要处理的一列,进入“数据—分列”,选择“分隔符号”,再勾选逗号、空格或自定义分隔符。确认预览、各列数据格式和目标位置后完成,操作前要给右侧结果预留空列。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。