Eclipse代码补全被Javadoc黄色弹窗遮挡问题求助

问题场景 #

在Eclipse 2025-06（4.36.0）版本的Java编辑器中，触发代码补全（Ctrl+Space快捷键或自动悬停触发）后，黄色Javadoc弹窗会几乎立即弹出，遮挡补全建议列表，导致代码补全功能难以正常使用。即使调整了Content Assist相关设置，甚至禁用Content Assist，Ctrl+Space触发时该Javadoc弹窗仍会出现。临时可通过持续按方向键移动补全窗口选中项阻止弹窗，但停止移动后弹窗仍会弹出。

调整方案 #

1. 延长Javadoc弹窗自动激活延迟 #

1. 打开Eclipse偏好设置：Windows/Linux用户点击Window > Preferences，Mac用户点击Eclipse > Settings
2. 依次展开Java > Editor > Content Assist > Javadoc
3. 在Auto activation delay输入框中设置更长的毫秒值（例如500或1000），点击Apply and Close保存设置

2. 修改Javadoc弹窗显示位置 #

在上述Java > Editor > Content Assist > Javadoc设置页面：

• 在Position下拉菜单中选择不遮挡补全列表的位置（如Bottom、Left或Right）
• 勾选Wrap text选项可限制弹窗宽度，减少遮挡范围

3. 禁用补全时自动弹出Javadoc弹窗 #

同样在Java > Editor > Content Assist > Javadoc设置页面：

• 取消勾选Show Javadoc window when selection changes选项，补全时将不再自动弹出Javadoc窗口
• 若需查看某补全项的Javadoc，可选中该项后按F2键手动触发

对Eclipse开发者的建议 #

建议将代码补全触发时的Javadoc弹窗延迟时间设为可配置项，让用户能根据自身使用习惯灵活调整，避免默认即时弹出的设计影响代码补全操作的流畅性。

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