如何使用 GroupDocs.Merger for Java 合并 TIFF 图像：一步一步指南

合并 TIFF 图像是摄影、归档和医学影像中常见的需求。在本教程中，您将学习 如何合并 TIFF 图像 为单个高质量文件，使用 GroupDocs.Merger for Java。我们将演示如何设置库、加载源文件、添加额外的 TIFF，并保存合并结果——全部使用清晰、可用于生产的代码。

快速答案

  • 什么库在 Java 中处理 TIFF 合并？ GroupDocs.Merger for Java。
  • 进行基本合并需要多少行代码？ 在初始化 Merger 对象后只需两行代码。
  • 我可以合并超过两个 TIFF 吗？ 是的 – 对每个额外文件重复调用 join。
  • 生产环境是否需要许可证？ 商业使用需要有效的 GroupDocs 许可证。
  • 支持哪些 Java 版本？ Java 8 及更高版本，包括 Java 11 和 Java 17。

什么是合并 TIFF 图像？

合并 TIFF 图像 是指将两个或多个独立的 TIFF 文件连接成一个多页 TIFF，且不丢失分辨率或元数据。此操作保留每页的原始压缩方式，非常适合归档工作流。生成的文件表现为单个文档，简化存储、分发和批处理，同时保留所有原始图像属性。

为什么使用 GroupDocs.Merger for Java？

GroupDocs.Merger 支持 30+ 输入和输出格式，并且能够在不将整个文档加载到内存中的情况下处理高达 2 GB 的 TIFF 文件，为即使是普通服务器也提供快速、低内存的合并。它还能自动保留元数据和页面顺序，减少自定义代码，其线程安全的 API 可平滑集成到 Spring 或其他 Java 框架中，适用于桌面和服务器应用。

前置条件

  • 本地已安装 JDK 8 或更高版本。
  • 使用 IntelliJ IDEA 或 Eclipse 等 IDE。
  • 使用 Maven 或 Gradle 进行依赖管理。
  • 获取有效的 GroupDocs.Merger 许可证（免费试用或已购买）。

为 Java 设置 GroupDocs.Merger

要开始合并 TIFF 文件，请将库添加到项目中。

Maven

将以下依赖添加到您的 pom.xml 文件中：

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-merger</artifactId>
    <version>latest-version</version>
</dependency>

Gradle

在您的 build.gradle 文件中加入此行：

implementation 'com.groupdocs:groupdocs-merger:latest-version'

直接下载

或者，从官方发布页面下载最新的 JAR： GroupDocs.Merger for Java releases。

获取许可证的步骤

如何使用 GroupDocs.Merger for Java 合并 TIFF 图像？

加载第一张 TIFF，针对每个额外图像调用 join，然后保存合并文档。整个过程仅需三次方法调用，通常在十页文件下不到一秒即可完成。您还可以在保存前设置压缩或元数据选项，API 支持流式操作，允许直接从内存或网络源加载文件，无需临时文件。

加载源 TIF 文件

Definition anchor: Merger 类是 GroupDocs.Merger 的核心入口点，表示内存中的可操作文档。

```java
   import com.groupdocs.merger.Merger;

   final String YOUR_DOCUMENT_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY";
   
   public class LoadTif {
       public static void run() throws Exception {
           // Create a Merger instance with the source TIFF file
           Merger merger = new Merger(YOUR_DOCUMENT_DIRECTORY + "/source.tif");
           // The source TIF file is now loaded into the Merger instance.
       }
   }


**Explanation:** 此代码片段创建一个指向初始 TIFF 文件的 `Merger` 实例，为后续操作准备 API。

### 添加另一个 TIF 文件进行合并
**Definition anchor:** `join` 方法将新文档（或页面）追加到当前加载的文件中，保留其原始格式。

```text
```java
   import com.groupdocs.merger.Merger;

   final String YOUR_DOCUMENT_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY";
   
   public class AddTifToMerge {
       public static void run() throws Exception {
           // Load the source TIF file into a Merger instance
           Merger merger = new Merger(YOUR_DOCUMENT_DIRECTORY + "/source.tif");
           
           // Add another TIF file to merge with the first one
           merger.join(YOUR_DOCUMENT_DIRECTORY + "/additional.tif");
           // Two TIF files are now ready for merging.
       }
   }


**Explanation:** 每次调用 `join` 都会将另一个 TIFF 添加到内存集合中，您可以构建多页结果。

### 合并 TIF 文件并保存结果
**Definition anchor:** `save` 方法将组合后的文档写入磁盘，使用您指定的格式。

```text
```java
   import com.groupdocs.merger.Merger;

   final String YOUR_DOCUMENT_DIRECTORY = "YOUR_DOCUMENT_DIRECTORY";
   final String YOUR_OUTPUT_DIRECTORY = "YOUR_OUTPUT_DIRECTORY";

   public class MergeAndSaveTif {
       public static void run() throws Exception {
           // Assume the TIF files have been loaded and added for merging in previous steps
           Merger merger = new Merger(YOUR_DOCUMENT_DIRECTORY + "/source.tif");
           merger.join(YOUR_DOCUMENT_DIRECTORY + "/additional.tif");

           // Define the output file path for the merged result
           String outputFile = YOUR_OUTPUT_DIRECTORY + "/merged.tif";
           
           // Perform the merge operation and save the result to the specified location
           merger.save(outputFile);
           // The TIFF files have been successfully merged and saved.
       }
   }


**Explanation:** 在所有所需文件加入后，`save` 将合并后的 TIFF 持久化到您提供的目标位置。

## 合并 TIFF 文件的实际应用
1. **文档归档：** 通过将扫描页合并为单个多页 TIFF 来降低存储开销。  
2. **摄影项目：** 将作为独立 TIFF 切片拍摄的全景图像拼接在一起。  
3. **医学影像：** 合并连续的放射片以形成完整的患者记录。  
4. **平面设计：** 在不重新压缩每一层的情况下组装分层艺术作品。  
5. **文档管理系统：** 通过每个文档只存储一个文件而不是多个文件来简化索引和检索。

## 性能考虑
### 优化性能的技巧
- 在 **流式模式** 下处理大型 TIFF，以将内存使用保持在 200 MB 以下。  
- 将并发合并数量限制为 CPU 核心数，以避免 CPU 限速。

### 资源使用指南
GroupDocs.Merger 会自动释放文件句柄，但仍建议将 `Merger` 实例包装在 try‑with‑resources 块中，以确保清理。

### 使用 GroupDocs.Merger 的 Java 内存管理最佳实践
- 使用 `try (Merger merger = new Merger(...)) { … }` 确保 `close()` 方法被调用。  
- 对于超大图像，设置 `MergerOptions.setCacheEnabled(true)` 以启用磁盘缓存。

## 常见问题及解决方案
- **在非常大的 TIFF 上出现 OutOfMemoryError：** 按上述方式启用缓存或将合并拆分为更小的批次。  
- **元数据丢失：** 在合并文件之前确保调用 `merger.getSettings().setPreserveMetadata(true)`。  
- **页面顺序错误：** 按所需的确切顺序添加文件；`join` 会遵循调用顺序。

## 常见问答

**Q: 如何高效处理大型 TIFF 文件？**  
A: 通过 `MergerOptions.setCacheEnabled(true)` 启用磁盘缓存，并分批处理文件，以保持低内存消耗。

**Q: 我可以一次合并超过两个 TIFF 文件吗？**  
A: 可以，在调用 `save` 之前对每个额外文件调用 `join` 即可。

**Q: 能否从字节数组而不是文件路径添加 TIFF 文件？**  
A: 完全可以——使用 `Merger(InputStream)` 构造函数直接从流加载图像。

**Q: 合并时 GroupDocs.Merger 是否保留 EXIF 等元数据？**  
A: 默认会保留元数据；您也可以通过 `MergerSettings.setPreserveMetadata(true)` 进行控制。

**Q: 官方支持哪些 Java 版本？**  
A: 完全支持 Java 8、11 和 17，并对早期基于 8 的运行时提供向后兼容。

## 结论
您现在拥有使用 GroupDocs.Merger for Java **合并 TIFF 图像** 的完整、可用于生产的工作流。该库简洁的 API、广泛的格式支持以及内存高效的设计，使其成为任何基于 Java 的图像处理流水线的首选方案。

### 下一步
- 探索 **拆分** 多页 TIFF 为单个文件。  
- 尝试使用相同的 `Merger` API 将合并的 TIFF **转换** 为 PDF 或 JPEG。  
- 将合并例程集成到现有的文档管理服务中，实现自动批处理。

---

**最后更新：** 2026-05-27  
**测试版本：** GroupDocs.Merger 23.12 for Java  
**作者：** GroupDocs

## 相关教程

- [如何使用 GroupDocs.Merger for Java 合并 PNG 图像 - 一步一步指南](/merger/java/document-information/merge-png-images-groupdocs-merger-java/)
- [Java 中图像合并精通：GroupDocs.Merger 对 BMP 文件的全面指南](/merger/java/image-operations/mastering-image-merging-java-groupdocs-merger/)
- [如何使用 GroupDocs.Merger for Java 合并 EMZ 文件：一步一步指南](/merger/java/format-specific-merging/merge-emz-files-groupdocs-merger-java/)