Eclipse中查看Javadoc及SWT对象悬停无Javadoc问题排查
嘿,我来帮你搞定这两个Eclipse里的Javadoc问题,尤其是第二个SWT的坑,我之前踩过,太懂那种明明关联了却没反应的郁闷了😉
这里给你列几个最常用的方法,按需选就行:
- 悬停快速查看:把鼠标直接悬停在类、方法或者变量上,默认会弹出带Javadoc的小窗口。如果没弹,去
Window > Preferences > Java > Editor > Hovers里看看,确保“Javadoc”选项是勾选状态。 - 打开专属视图:点击
Window > Show View > Other...,搜索“Javadoc”打开这个视图,之后选中代码里的任意元素,视图会自动同步显示对应的完整Javadoc。 - 快捷键直达:选中元素后按
F2,会弹出Javadoc弹窗;或者按Shift+F2,直接在外部浏览器打开该元素的完整Javadoc(前提是已经正确关联了文档)。 - 直接打开类文档:右键代码里的类名,选择
Open Javadoc,就能在Eclipse内部或外部浏览器打开这个类的完整Javadoc页面。
你已经下载了SWT Javadoc Jar并关联,但还是没效果,结合你用的是2020-06版EE Eclipse,大概率是这几个细节没做好:
必须严格匹配SWT版本!
这是最容易踩的坑:SWT的Javadoc版本必须和你的Eclipse版本完全对应!你用的2020-06版Eclipse对应的是4.16版本号,所以你下载的SWT Javadoc Jar必须是4.16版本的,不能随便下其他版本的。
另外,其实你不用手动去官网下载,Eclipse安装目录的plugins文件夹里自带对应版本的SWT Javadoc插件(文件名一般是org.eclipse.swt.doc_4.16.0.vxxxxxx.jar这种,版本号要和你的SWT库一致)。你可以打开项目的Properties > Java Build Path > Libraries,找到SWT的Jar(比如Windows下是org.eclipse.swt.win32.win32.x86_64.jar),展开它双击“Javadoc location”,选择“Javadoc in archive”,然后直接指定这个自带的doc插件就行,比手动下载更靠谱。检查Eclipse的Javadoc显示设置
去Window > Preferences > Java > Editor > Hovers,确保“Combined Hover”和“Javadoc”都被勾选,而且Javadoc的优先级要靠前;另外再去Window > Preferences > Java > Editor > Content Assist > Advanced,确认“Javadoc”选项是启用状态。清理项目缓存&重启Eclipse
有时候项目的缓存会搞鬼,试试点击Project > Clean...,选中你的项目清理后重新构建;或者右键项目选Refresh,实在不行就重启Eclipse,很多小问题重启就解决了。排查SWT库冲突
检查项目的Build Path里的Libraries,确保只有一个对应Eclipse版本的SWT Jar,要是有其他旧版本的SWT库,赶紧移除——多个版本的SWT共存很容易导致Javadoc关联失效。
内容的提问来源于stack exchange,提问作者Kid

