如何在 Maven Javadoc 中跨模块聚合依赖项目的源码文档

编程并不是一个机械性的工作，而是需要有思考，有创新的工作，语法是固定的，但解决问题的思路则是依靠人的思维，这就需要我们坚持学习和更新自己的知识。今天golang学习网就整理分享《如何在 Maven Javadoc 中跨模块聚合依赖项目的源码文档 》，文章讲解的知识点主要包括，如果你对文章方面的知识点感兴趣，就不要错过golang学习网，在这可以对大家的知识积累有所帮助，助力开发能力的提升。

通过配置 maven-javadoc-plugin 的 includeDependencySources 和 dependencySourceIncludes，可将依赖模块（如模块 B）的源码及 JavaDoc 自动合并到当前模块（如模块 A）生成的文档中，实现跨模块类型链接与完整 API 参考。

通过配置 `maven-javadoc-plugin` 的 `includeDependencySources` 和 `dependencySourceIncludes`，可将依赖模块（如模块 B）的源码及 JavaDoc 自动合并到当前模块（如模块 A）生成的文档中，实现跨模块类型链接与完整 API 参考。

要在模块 A 的 Javadoc 中正确显示来自模块 B 的类型（例如 RespostDTO）的完整文档，关键在于让 maven-javadoc-plugin 不仅解析本模块源码，还能“感知”并内联依赖模块的源代码（而非仅 .jar 文件）。这需要满足两个前提条件：

✅ 模块 B 必须发布源码包（-sources.jar）
确保模块 B 在构建时启用 maven-source-plugin 并成功部署 artifactId-B-x.x.x-sources.jar 到内部仓库（如 Nexus 或 Artifactory）。典型配置如下：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-source-plugin</artifactId>
  <version>3.2.1</version>
  <executions>
    <execution>
      <id>attach-sources</id>
      <goals><goal>jar-no-fork</goal></goals>
    </execution>
  </executions>
</plugin>

✅ 模块 A 的 pom.xml 中启用依赖源码聚合
在模块 A 的 中配置 maven-javadoc-plugin，启用 includeDependencySources 并精确声明需包含的依赖坐标：

<plugin>
  <groupId>org.apache.maven.plugins</groupId>
  <artifactId>maven-javadoc-plugin</artifactId>
  <version>3.6.3</version>
  <configuration>
    <!-- 显式指定本模块源路径（可选，通常自动识别） -->
    <sourcepath>${basedir}/src/main/java</sourcepath>

    <!-- 启用依赖源码解析 -->
    <includeDependencySources>true</includeDependencySources>

    <!-- 精确限定哪些依赖的源码参与聚合 -->
    <dependencySourceIncludes>
      <!-- 匹配模块B的全部版本：group.id:B-artifact-id -->
      <dependencySourceInclude>com.example:module-b</dependencySourceInclude>
      <!-- 或按 Group ID 模糊匹配多个模块（谨慎使用） -->
      <!-- <dependencySourceInclude>com.example:*</dependencySourceInclude> -->
    </dependencySourceIncludes>

    <!-- （推荐）启用链接到已部署的在线 JavaDoc（增强可维护性） -->
    <links>
      <link>https://your-internal-repo.com/javadoc/module-b/</link>
    </links>
  </configuration>
</plugin>

⚠️ 重要注意事项：

• includeDependencySources 仅对 已安装或已部署的 -sources.jar 生效，若本地未 mvn install 模块 B 或仓库中缺失源码包，插件将静默跳过，不报错但无效果；
• 使用通配符（如 com.example:*）可能引入无关模块源码，增加构建耗时与文档体积，建议显式列出必要依赖；
• 若模块 B 的 JavaDoc 已在线托管（如内部 Nexus 的 javadoc repo），配合 可实现更轻量的跨模块跳转（无需下载源码），且支持增量更新；
• 执行聚合命令时，请使用 mvn javadoc:javadoc（单模块）或 mvn javadoc:aggregate（多模块聚合根项目），后者更适合多模块工程统一文档输出。

最终效果：当模块 A 的 testMethod() 方法签名中引用 RespostDTO 时，生成的 HTML 文档中该类型名将变为可点击链接，点击后直接跳转至模块 B 中 RespostDTO 类的完整 JavaDoc 页面——真正实现企业级多模块项目的无缝文档集成。

到这里，我们也就讲完了《如何在 Maven Javadoc 中跨模块聚合依赖项目的源码文档 》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！