Eclipse 无法补全 com.sun 包解决方法

Eclipse 默认会过滤掉 `com.sun.等非标准 JDK 内部 API 包，导致输入com.sun.` 时无类型提示；本文详解如何通过调整「Type Filters」设置恢复可见性，并强调使用这些内部类的风险与替代方案。

Eclipse 默认会过滤掉 com.sun.* 等非标准 JDK 内部 API 包，导致输入 com.sun. 时无类型提示；本文详解如何通过调整「Type Filters」设置恢复可见性，并强调使用这些内部类的风险与替代方案。

在 Eclipse 中编写 Java 代码时，若输入 com.sun. 后未出现任何自动补全（Content Assist）建议（如 com.sun.jna.* 相关类），并非项目配置错误或 JNA 库未正确添加，而极大概率是 Eclipse 的 Type Filters（类型过滤器） 在起作用。

Eclipse 默认将 com.sun.*、sun.* 等 JDK 内部实现包列入过滤列表——这是出于工程规范考虑：这些包不属于 Java SE 标准 API，不保证跨版本兼容，且可能在不同 JVM（如 OpenJDK vs Oracle JDK）中行为不一致或直接缺失。

✅ *解决方法：取消对 com.sun. 的类型过滤**

1. 打开 Eclipse 菜单：Window → Preferences（macOS 为 Eclipse → Preferences）
2. 导航至：Java → Appearance → Type Filters
3. 在过滤规则列表中，找到类似以下条目并取消勾选：
   • com.sun.*
   • sun.*（如需同时查看其他内部类）
4. 点击 Apply and Close
5. 重启 Eclipse（重要！部分版本需重启才能使过滤器变更生效）

之后，在编辑器中输入 com.sun.，即可看到 com.sun.jna.Native、com.sun.jna.Library 等 JNA 相关类出现在内容辅助列表中。

⚠️ *重要提醒：谨慎使用 com.sun. 类型**

• com.sun.jna.* 实际上是 JNA 库自身的包路径（由 JNA 项目定义，非 JDK 内部包），它本不应被 com.sun.* 过滤规则拦截——但因历史命名习惯（JNA 早期曾托管于 com.sun 域下），Eclipse 默认过滤仍会误伤。
• 若你真正想用的是 JNA 功能，推荐始终通过标准方式引入：

  <!-- Maven 示例 -->
  <dependency>
      <groupId>net.java.dev.jna</groupId>
      <artifactId>jna</artifactId>
      <version>5.14.0</version>
  </dependency>

  并在代码中显式导入：

  import com.sun.jna.Library;
  import com.sun.jna.Native;

? 补充排查建议

• 确保 JNA JAR 已正确添加至 Build Path（右键项目 → Properties → Java Build Path → Libraries → Add External JARs）；
• 检查 Package Explorer 中是否可见 com.sun.jna 包结构（展开 Referenced Libraries 即可验证）；
• 若仅 com.sun.jna 不显示，而 java.util.* 等正常，则基本可锁定为 Type Filters 问题，无需修改 .classpath 或重建项目。

总之，这不是环境故障，而是 Eclipse 主动保护开发者远离不稳定 API 的设计体现。合理配置 Type Filters，既能满足开发调试需求，又能保持代码长期可维护性。