在 Java 中将 Excel 转换为图像

Tue, 25 Aug 2026 19:13:32 +0000

在构建报告仪表板或电子邮件摘要时，生成电子表格数据的可视化预览是常见需求。 Conholdate.Total for Java 提供了强大的 SDK，简化了在 Java 应用程序中将 Excel 转换为图像的过程。在本指南中，您将看到如何加载 XLSX 工作簿，配置 JPEG 输出，并将工作表页面渲染为图像文件。完成后，您将拥有一个可直接运行的代码示例，能够适配到您自己的项目中。

将 Excel 文件转换为图像对您的应用程序的需求

开发人员经常需要将电子表格内容转换为静态图像，以用于网页预览、PDF 报告或移动端缩略图。通常的需求包括保留单元格格式、准确渲染工作表内容以及控制图像分辨率。手动打开 Excel、截屏并保存的方式无法规模化，且可能导致结果不一致。

可靠解决方案的技术约束包括：支持 XLSX 文件、准确渲染工作表布局、可配置的图像分辨率，以及能够处理跨多页打印的工作表。转换必须在服务器或桌面环境中运行，无需 Microsoft Office。

为工作选择 Conholdate.Total for Java

Conholdate.Total for Java 提供了一个直接的 API，涵盖所有所需的功能。Workbook 和 Worksheet 类让您可以直接访问电子表格内容，而 ImageOrPrintOptions 则提供对分辨率和图像格式的细粒度控制，SheetRender 负责实际的逐页渲染。该 SDK 可在任何 Java 运行时上运行，仅需 Maven 依赖，并能高效处理大型工作簿。

有关详细的 API 用法，请参阅官方文档。Workbook、Worksheet、ImageOrPrintOptions 和 SheetRender 等类的完整参考可在API 参考中找到。您可以从发布页面下载最新的库。

在 Java 中实现 Excel 转图片转换

转换过程可以分解为几个清晰的步骤。以下章节将逐步引导您了解每个部分，并直接摘取完整示例中的简短代码片段。

通过 Maven 安装 Conholdate.Total for Java

将 Conholdate Maven 仓库和 SDK 依赖添加到您的 pom.xml 中：


  
    conholdate-repo
    Conholdate Maven Repository
    https://repository.conholdate.com/repo/
  



  com.conholdate
  conholdate-total
  24.9
  pom

加载 Excel 文件并访问工作表

使用 Workbook 类加载工作簿，然后获取要转换的工作表的引用：

// Load Excel file
com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

配置 JPEG 的图像输出选项

使用 ImageOrPrintOptions 设置所需的图像分辨率和格式：

// 设置图像选项
com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
options.setHorizontalResolution(200);
options.setVerticalResolution(200);
options.setImageType(com.aspose.cells.ImageType.JPEG);

将工作表渲染为 JPEG 图像

为工作表创建一个 SheetRender，并遍历其页面，将每个页面保存为单独的 JPEG 文件。工作表可能跨越多个打印页，因此 getPageCount() 告诉您需要多少图像：

// Convert sheet to JPG image
com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
for (int j = 0; j < sr.getPageCount(); j++)
{
    sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
}

上述步骤演示了如何使用 Conholdate.Total for Java SDK 将 Excel 转换为图像，同时让您能够控制分辨率、格式和多页工作表。

完整代码示例：将 Excel 转换为图像（支持完整工作表）

以下代码展示了上述步骤中描述的完整、可直接运行的实现。

public class ExcelToImageConverter {
    public static void main(String[] args) throws Exception {
        // Load Excel file
        com.aspose.cells.Workbook book = new com.aspose.cells.Workbook("input.xlsx");

// Get the reference of the desired worksheet
        com.aspose.cells.Worksheet sheet = book.getWorksheets().get(0);

// Set image options
        com.aspose.cells.ImageOrPrintOptions options = new com.aspose.cells.ImageOrPrintOptions();
        options.setHorizontalResolution(200);
        options.setVerticalResolution(200);
        options.setImageType(com.aspose.cells.ImageType.JPEG);

// Convert sheet to JPG image
        com.aspose.cells.SheetRender sr = new com.aspose.cells.SheetRender(sheet, options);
        for (int j = 0; j < sr.getPageCount(); j++)
        {
            sr.toImage(j, "excel-to-jpg" + (j + 1) + ".jpg");
        }

System.out.println("Excel to image conversion completed successfully.");
    }
}

注意： 此代码示例演示了核心功能。在项目中使用之前，请确保更新文件路径（input.xlsx）以匹配实际文件位置，验证所有必需的依赖项已正确安装，并在开发环境中彻底测试。如果遇到任何问题，请参考官方文档或联系支持团队获取帮助。

结论

在 Java 中将 Excel 转换为图像变得直观，只要利用 Conholdate.Total for Java。SDK 处理工作表渲染，并以最少的代码生成高质量的 JPEG 输出。按照分步指南，您可以将此功能集成到报表工具、电子邮件生成器或任何需要可视化电子表格表示的应用程序中。请记住，生产部署需要商业许可证；您可以在 Conholdate.Total pricing 页面查看定价选项，并在评估期间从 temporary license page 获取临时许可证。

FAQs

如何在 Java 中将 Excel 转换为图像？
使用 Workbook 加载文件，从 book.getWorksheets() 获取所需的工作表，配置 ImageOrPrintOptions，然后使用 SheetRender 进行渲染。
我可以将特定的 Excel 工作表转换为图像吗？
是的。使用 book.getWorksheets().get(index) 选择工作表，然后将其传递给 SheetRender 进行转换。
为什么我会从单个工作表得到多个图像文件？
工作表可能跨越多个打印页。SheetRender.getPageCount() 返回页数，循环会为每页保存一个图像。
生产使用需要什么许可？
需要商业许可证。请在 Conholdate.Total 定价页面查看费用，并从临时许可证页面获取临时许可证。

spreadsheet image generation on Conholdate Blog