VSCode可识别javax.servlet包但编译提示包不存在如何解决

VSCode编辑阶段可识别javax.servlet包，是Java语言服务完成了依赖索引，但编译环节未将servlet相关依赖加入实际编译类路径，就会触发package javax.servlet does not exist报错。当前使用的Tomcat5.5属于早期版本，servlet-api包的存放路径和高版本Tomcat不一致，极易出现路径配置错误。

• 第一步：校验本地Tomcat5.5目录下的依赖包位置，对应servlet-api.jar的正确路径为Tomcat5.5安装根目录/common/lib/servlet-api.jar，不要误引用高版本Tomcat放在根目录/lib下的包，版本不匹配也会触发报错。
• 第二步：如果是Maven管理的项目，在pom.xml中引入适配Tomcat5.5、JDK1.5的servlet-api 2.4版本依赖，设置scope为provided避免和Tomcat运行时自带的包冲突：

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

• 第三步：如果是无构建工具的普通Java项目，手动将servlet-api.jar加入项目编译类路径：开启VSCode隐藏文件显示，打开项目根目录下的.classpath文件，新增如下配置项，替换path值为你本地servlet-api.jar的实际绝对路径：

<classpathentry kind="lib" path="你的本地Tomcat5.5路径/common/lib/servlet-api.jar"/>

• 第四步：配置完成后按Ctrl+Shift+P调出VSCode命令面板，执行Java: Clean Java Language Server Workspace命令，等待Java语言服务重启完成后再执行编译。如果是手动调用javac命令行编译，必须在-cp参数中显式带上servlet-api.jar的路径，示例命令：

javac -cp ".;C:/tomcat5.5/common/lib/servlet-api.jar" YourServletFile.java

注意：不要为了省事把servlet-api.jar复制到JDK的jre/lib/ext目录做全局依赖配置，后续升级Tomcat或JDK版本时极易出现类冲突问题。

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