如何在IntelliJ IDEA中为Maven项目正确添加Javadoc JAR包？

你遇到的问题根源在于：IntelliJ的Maven集成会完全依据pom.xml同步依赖配置，手动通过「Project Structure」修改的库配置，会在Maven重新导入时被覆盖。要彻底解决这个问题，得从Maven配置层面入手，而非手动修改IDE设置。

方法一：将本地库安装到Maven本地仓库（推荐） #

这是最规范的做法，Maven会自动识别并关联主JAR和Javadoc JAR，IDEA也能自动同步配置，不会丢失。

执行以下两条Maven命令（替换com.redacted为你的实际groupId，libraries为artifactId）：

• 安装主JAR包：

  mvn install:install-file -Dfile=redacted-libraries-0.0.1.jar -DgroupId=com.redacted -DartifactId=libraries -Dversion=0.0.1 -Dpackaging=jar
  

• 安装Javadoc JAR包（注意-Dclassifier=javadoc参数，这是Maven识别javadoc包的关键）：

  mvn install:install-file -Dfile=redacted-libraries-0.0.1-javadocs.jar -DgroupId=com.redacted -DartifactId=libraries -Dversion=0.0.1 -Dpackaging=jar -Dclassifier=javadoc
  

之后在项目的pom.xml中添加常规依赖即可：

<dependency>
    <groupId>com.redacted</groupId>
    <artifactId>libraries</artifactId>
    <version>0.0.1</version>
</dependency>

重新导入Maven项目后，IDEA会自动加载Javadoc，无需手动配置。

方法二：直接在pom.xml中关联本地文件（不推荐，仅临时场景使用） #

如果不想将库安装到本地仓库，可通过system依赖+插件配置直接关联本地文件，但这种方式依赖本地路径，团队协作时需要同步文件位置，灵活性差。

在pom.xml中添加如下配置：

<!-- 主JAR依赖 -->
<dependency>
    <groupId>com.redacted</groupId>
    <artifactId>libraries</artifactId>
    <version>0.0.1</version>
    <scope>system</scope>
    <!-- 替换为你的本地主JAR路径 -->
    <systemPath>${project.basedir}/lib/redacted-libraries-0.0.1.jar</systemPath>
</dependency>

<!-- 关联Javadoc -->
<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>3.5.0</version>
            <configuration>
                <!-- 替换为你的本地Javadoc JAR路径 -->
                <javadocPaths>
                    <javadocPath>${project.basedir}/lib/redacted-libraries-0.0.1-javadocs.jar</javadocPath>
                </javadocPaths>
            </configuration>
        </plugin>
    </plugins>
</build>

重新导入Maven项目后，IDEA就能识别Javadoc，且配置不会被覆盖。

内容的提问来源于stack exchange，提问作者Francis Rubio