如何在Eclipse中自动关联Javadoc或指定Javadoc存储位置

现有配置问题排查 #

• 确认mypackage.jar.properties文件与mypackage.jar存放在同一级libs根目录下，不能放到子目录中
• 验证路径拼写与大小写完全匹配：doc=docs/mypackage-javadoc.jar对应的实际文件路径必须是libs/docs/mypackage-javadoc.jar，macOS/Linux系统对大小写敏感，需注意文件名大小写一致
• 配置修改完成后，右键项目选择刷新，或重启Eclipse后重新导入Jar包验证

自动关联Javadoc的实现方案 #

方案1：命名规则适配（无需额外配置） #

Eclipse内置自动识别规则，只要把mypackage-javadoc.jar和mypackage.jar放在同一级目录下，不需要编写properties文件，导入Jar包时Eclipse会自动扫描关联对应的Javadoc文件。

方案2：配置全局用户库（适用于多项目复用） #

如果需要在多个项目中复用该自定义Jar包，可通过Eclipse用户库实现一次配置多处生效：

1. 打开Eclipse菜单栏窗口→首选项→Java→构建路径→用户库
2. 点击新建，输入自定义库名称（例如MyCustomTools），选中新建的库后点击添加外部JAR，选择本地的mypackage.jar
3. 展开刚导入的Jar包条目，选中Javadoc 位置，点击右侧编辑按钮
4. 选择归档中的Javadoc，浏览选中对应的mypackage-javadoc.jar文件后保存配置
5. 后续项目需要导入该Jar包时，直接选择添加库→用户库，勾选你配置的自定义库即可自动关联Javadoc

方案3：Maven仓库托管（适用于Maven/Gradle项目） #

如果项目使用Maven管理依赖，可将Jar包和Javadoc包安装到本地Maven仓库，实现自动关联：

1. 安装Jar包到本地仓库，执行命令：

mvn install:install-file -Dfile=libs/mypackage.jar -DgroupId=com.yourdomain -DartifactId=mypackage -Dversion=1.0.0 -Dpackaging=jar

2. 安装对应的Javadoc包到本地仓库，执行命令：

mvn install:install-file -Dfile=libs/docs/mypackage-javadoc.jar -DgroupId=com.yourdomain -DartifactId=mypackage -Dversion=1.0.0 -Dpackaging=jar -Dclassifier=javadoc

3. 在项目的pom.xml中添加对应依赖即可，Eclipse Maven插件会自动匹配关联同版本的Javadoc包

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