本教程旨在解决eclipse ide中`jdk.*`包自动补全功能失效的问题。默认情况下，eclipse会过滤掉`jdk.*`包的类型提示，导致开发者在使用这些内部api时无法获得代码补全。本文将详细指导您如何通过修改eclipse偏好设置，禁用此默认过滤，从而恢复对`jdk.*`包的完整代码补全支持。
引言：理解jdk.*包自动补全问题
在Eclipse集成开发环境中，开发者有时会遇到一个特定问题：当尝试使用jdk.*包（例如jdk.jshell.*）中的类或接口时，代码自动补全功能无法正常工作。具体表现为，当输入对象名后紧跟点操作符（.）时，Eclipse仅提供java.lang.Object类的方法建议，而未能显示jdk.*包中目标类型特有的方法和字段。这无疑会降低开发效率，尤其是在需要频繁查阅内部API时。
此现象并非Eclipse的缺陷，而是其默认配置所致。Eclipse为了避免不必要的提示和潜在的内部API误用，默认将jdk.*包设置为类型过滤器，使其不参与常规的代码补全。
解决步骤：启用jdk.*包自动补全
要解决jdk.*包自动补全功能失效的问题，您需要修改Eclipse的偏好设置，禁用对这些包的类型过滤。请按照以下步骤操作：
-
打开Eclipse偏好设置
- 在Windows或Linux系统上，点击菜单栏的 Window > Preferences。
- 在macOS系统上，点击菜单栏的 Eclipse > Preferences。
-
导航至“类型过滤器”设置
- 在偏好设置窗口的左侧导航栏中，展开 Java 节点。
- 继续展开 Appearance（外观）节点。
- 点击选择 Type Filters（类型过滤器）。
-
*取消选中`jdk.`过滤器**
- 在“类型过滤器”面板中，您会看到一个列表，其中包含当前被过滤的类型或包。
- 找到列表中的 jdk.* 项。
- 取消选中 jdk.* 项旁边的复选框。
-
应用并关闭设置
- 点击偏好设置窗口右下角的 Apply and Close（应用并关闭）按钮，保存您的更改。
完成上述步骤后，Eclipse将不再过滤jdk.*包，其内部类型和方法将参与到代码自动补全的建议列表中。
示例与验证
考虑以下使用jdk.jshell.*包的Java代码片段：
import jdk.jshell.*;
public class Test {
private static final JShell JSHELL = JShell.create();
public static void main(String[] args) {
// 在此处输入 JSHELL. 并观察自动补全提示
}
}在修改设置之前，当您在main方法中输入JSHELL.时，Eclipse可能只会显示Object类的方法（如equals(), hashCode(), toString()等）。
完成上述配置更改并重启Eclipse（如果需要）后，再次在main方法中输入JSHELL.，您将看到JShell接口特有的方法和字段，例如eval(), onShutdown(), sourceCodeAnalysis()等，这表明jdk.*包的自动补全功能已成功恢复。
注意事项
- 默认过滤的原因： jdk.*包通常包含Java虚拟机（JVM）的内部API，这些API并非设计给普通应用程序开发者直接使用。Oracle官方不保证这些内部API的兼容性和稳定性，它们可能在未来的Java版本中发生变化或被移除。Eclipse默认过滤它们，旨在引导开发者优先使用标准Java API，并避免对不稳定内部API的依赖。
- 谨慎使用： 只有当您明确知道自己在做什么，并且确实需要访问jdk.*包中的特定内部API时，才建议启用此功能。在大多数情况下，标准的java.*和javax.*包已能满足日常开发需求。
- 全局设置： “类型过滤器”是Eclipse的全局设置，一旦修改，将影响所有Java项目。如果您在某个项目中启用了jdk.*的自动补全，那么所有其他项目也将受此影响。
总结
通过简单地取消选中Eclipse偏好设置中的jdk.*类型过滤器，您可以轻松解决jdk.*包自动补全功能失效的问题。尽管此功能在特定场景下非常有用，但开发者应充分理解jdk.*包的性质及其潜在风险，并根据实际需求谨慎使用。正确配置Eclipse，能够显著提升开发效率和体验。
