如何在Eclipse 4.37.0中为Jakarta Faces 4（Facelets）启用标签自动补全

Jakarta Faces 4确实移除了传统的TLD文件，转而使用META-INF/taglib.xml作为标签库的元数据载体。要在Eclipse 4.37.0中恢复Facelets标签自动补全，按以下步骤操作：

• 确保项目依赖配置正确
  无论是Maven还是Gradle项目，必须引入Jakarta Faces 4.x的API和实现（比如Mojarra 4.x）。以Maven为例，pom.xml中要包含：

  <dependency>
      <groupId>jakarta.faces</groupId>
      <artifactId>jakarta.faces-api</artifactId>
      <version>4.0.1</version>
      <scope>provided</scope>
  </dependency>
  <dependency>
      <groupId>org.glassfish</groupId>
      <artifactId>jakarta.faces</artifactId>
      <version>4.0.1</version>
      <scope>runtime</scope>
  </dependency>
  

  避免混用javax.faces的旧依赖，否则Eclipse无法识别Jakarta Faces 4的标签元数据。

• 配置项目Facet
  右键项目 → Properties → Project Facets，确认已勾选Jakarta Faces 4.0，并在右侧Runtime中选择支持Jakarta EE 9+的服务器（比如Tomcat 10.x、WildFly 26+等）。如果没有合适的Runtime，先在Eclipse的Server视图中添加对应服务器。

• 正确声明Facelets命名空间
  在你的.xhtml页面中，确保使用Jakarta Faces的标准命名空间，示例：

  <html xmlns="http://www.w3.org/1999/xhtml"
        xmlns:h="http://xmlns.jcp.org/jsf/html"
        xmlns:f="http://xmlns.jcp.org/jsf/core"
        xmlns:ui="http://xmlns.jcp.org/jsf/facelets">
  

  这些命名空间在Jakarta Faces 4中依然有效，Eclipse会通过依赖JAR中的taglib.xml识别标签。

• 触发Eclipse索引更新
  有时候Eclipse不会自动扫描新依赖的元数据，执行以下操作：

  1. 右键项目 → Refresh
  2. 顶部菜单Project → Clean...，选择当前项目并执行清理
  3. 重启Eclipse，让它重新解析项目依赖中的标签库配置

• 检查Eclipse的JSF内容辅助设置
  打开Window → Preferences → Jakarta Faces → Tools → Content Assist，确认以下选项已勾选：

  • Propose tags from tag libraries
  • Propose attributes for tags
    同时确保“Delay in ms”设置合理（比如500ms），避免补全触发过慢。

• 第三方组件库的支持
  如果使用PrimeFaces等第三方组件库，确保引入的是支持Jakarta Faces 4的版本，且组件库的JAR中包含META-INF/taglib.xml（而非旧的TLD）。Eclipse 4.37.0会自动读取这个文件提供补全。

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