当前位置：首页 > news >正文

获取 Excel 工作表的名字【Java 图文详解】

news 2025/10/31 14:42:24

当我们在处理复杂的 Excel 文件时，找到特定工作表常常让人头疼。尤其当文件包含几十个工作表的时候，手动查找不仅浪费时间，还容易出错。由此，本文将介绍一种更高效的方式——通过 Java 自动化快速获取所有工作表名称，让数据管理变得更轻松、更精准。

本文使用到的 Java 库是 Spire.XLS for Java，作为一个专业的 Java Excel 库，这个组件能轻松完成从转换 Excel 工作表到编辑、复制等一系列难易程度不同的任务。开发者可以导航到官方网站了解更多信息和获取安装包。

Java 获取所有 Excel 工作表的名字

在将 Java 库准备就绪后，我们直入正题：如何用 Java 获取 Excel 文件中所有工作表的名称。使用 Spire.XLS 时，可调用 Worksheet.getName() 来读取单个工作表的名字，但为确保不遗漏任何表，需要先遍历 Workbook 中的所有工作表并对每一项调用该方法。下面将分步讲解实现思路，随后给出完整可运行的代码示例，方便你直接上手。

Java 获取 Excel 工作表的名字的步骤：

创建 Workbook 对象然后加载 Excel 文档。
创建 StringBulider，用以储存获取的信息。
遍历所有工作表，然后通过 Worksheet.getName() 方法获取当前工作表的名称，然后将其添加到 StringBuilder 实例中。
将 StringBulider 中的内容写为 text 文件并保存。

下方代码展示了如何使用 Java 获取 Excel 文件中所有工作表的名字：

import java.io.*;  
import com.spire.xls.*;  public class GetWorksheetNames {  public static void main(String[] args) throws IOException {  // 创建一个 Workbook 对象  Workbook workbook = new Workbook();  // 加载 Excel 文件  workbook.loadFromFile("E:/Administrator/Python1/input/美洲国家.xlsx");  // 创建一个 StringBuilder 实例，用以保存提取到的工作表名称  StringBuilder stringBuilder = new StringBuilder();  // 遍历工作表  for (Object worksheet : workbook.getWorksheets()) {  // 获取当前工作表  Worksheet sheet = (Worksheet) worksheet;  // 获取工作表的名称。并将其添加到 StringBuilder 中  stringBuilder.append(sheet.getName() + "\r\n");  }  // 将 StringBuilder 的内容写入到文本文件中  FileWriter fw = new FileWriter("E:/Administrator/Python1/output/获取excel工作表名称.txt", true);  BufferedWriter bw = new BufferedWriter(fw);  bw.append(stringBuilder);  bw.close();  fw.close();  // 释放资源  workbook.dispose();  }  
}

下面是使用该代码得到的工作表名字：
使用 Java 获取 Excel 中所有表格的名字

进阶设置：仅输出可见表或隐藏表的名字

在前面的代码中，我们得到了所有工作表的名称。但在某些场景下，我们只希望查看可见的表，或反过来检查哪些被隐藏了。此时，就可以利用 Spire.XLS 提供的 WorksheetVisibility 枚举类来实现筛选。通过判断每个工作表的可见性状态，你就能灵活地输出可见或隐藏的工作表名称。下面是具体的实现思路：

加载 Excel 文件。
创建 StringBulider，用以储存获取的信息。
遍历所有工作表，通过 WorksheetVisibility 来设置输出内容。
- 当 sheet.getVisibility() == WorksheetVisibility.Visible 时，仅输出可见表的名称。
- 当 sheet.getVisibility() == WorksheetVisibility.Hidden 时，仅输出隐藏表的名称
然后通过 Worksheet.getName() 方法获取工作表的名称，然后将其添加到 StringBuilder 实例中。
将 StringBulider 中的工作表名字写为 text 文件并保存。

下方代码展示了怎样通过 Java 获取隐藏工作表的名字：

import java.io.*;  
import com.spire.xls.*;  public class GetHiddenWorksheetNames {  public static void main(String[] args) throws IOException {  // 创建一个 Workbook 对象  Workbook workbook = new Workbook();  // 加载 Excel 文件  workbook.loadFromFile("/input/美洲国家.xlsx");  // 创建一个 StringBuilder 以储存提取的工作表名称  StringBuilder stringBuilder = new StringBuilder();  // 遍历所有工作表  for (Object worksheet : workbook.getWorksheets()) {  // 获取当前工作表  Worksheet sheet = (Worksheet) worksheet;  // Detect the hidden worksheet 检查工资表是否被隐藏  if (sheet.getVisibility() == WorksheetVisibility.Hidden) {  // 输出可见表  //if (sheet.getVisibility() == WorksheetVisibility.Visible)  // 获取隐藏工作表的名称并添加到 StringBuilder 中  stringBuilder.append(sheet.getName() + "\r\n");  }  }  // 将 StringBuilder 的内容写入到文本文件中  FileWriter fw = new FileWriter("/output/获取隐藏工作表名称.txt", true);  BufferedWriter bw = new BufferedWriter(fw);  bw.append(stringBuilder);  bw.close();  fw.close();  // 释放资源  workbook.dispose();  }  
}

使用 Java 仅输出隐藏工作表名字的结果文件预览：
使用 Java 获取 Excel 中隐藏表格的名字

总结

在本篇教程中，我们介绍了如何使用 Java 和 Spire.XLS 来获取 Excel 文件中的工作表名称，包括遍历所有工作表以及根据可见性筛选输出可见或隐藏的表。通过掌握这些方法，处理复杂 Excel 文件时能够更加高效、精准地定位所需数据。若需要进一步实践，可以访问 Spire.XLS 的官方网站获取最新版本，方便在自己的项目中直接使用这些功能。