如何在IntelliJ Ultimate中为Java EE 8+Tomcat 8.5添加javax.servlet文档

可以通过以下两种方式解决Tomcat相关库（如javax.servlet）无文档提示的问题：

方法一：通过Tomcat SDK配置关联本地文档 #

• 打开IntelliJ，按下快捷键Ctrl+Alt+Shift+S打开项目结构窗口（或通过File > Project Structure进入）
• 在左侧菜单选择SDKs，找到当前项目使用的Apache Tomcat 8.5.x SDK
• 切换到Documentation Paths标签页
• 点击窗口右侧的+按钮，选择Add，然后定位到本地Tomcat安装目录下的docs文件夹（完整Tomcat安装包自带该目录），选中后确认
• 点击Apply和OK保存配置，重启IntelliJ后，鼠标悬停到Tomcat相关类/方法上就能看到文档提示了

方法二：通过依赖管理工具下载文档 #

如果项目用Maven或Gradle管理依赖：

• Maven：在pom.xml中确保servlet-api依赖的scope设为provided，然后在IntelliJ的Maven面板中找到该依赖，右键选择Download Sources and Documentation，IDE会自动下载并关联对应版本的文档

  <dependency>
      <groupId>javax.servlet</groupId>
      <artifactId>javax.servlet-api</artifactId>
      <version>4.0.1</version>
      <scope>provided</scope>
  </dependency>
  

• Gradle：在build.gradle中将servlet-api依赖的配置设为providedRuntime，同样右键该依赖选择下载文档

  providedRuntime 'javax.servlet:javax.servlet-api:4.0.1'
  

注意事项 #

• 确保你安装的是Tomcat 8.5的完整安装包，精简版不含docs目录，无法关联本地文档
• 文档版本要与依赖版本匹配，Java EE 8对应servlet-api 4.0.x，Tomcat 8.5原生支持该版本

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