Linux下VSCode如何将Tomcat 9 lib文件夹添加为Server Runtime

一、VSCode（Linux环境）配置Tomcat 9为Server Runtime #

前置要求：已安装Community Server Connectors插件，该插件是VSCode管理服务器运行时的核心依赖。

• 打开VSCode侧边栏的「Servers」面板，点击面板右上角的+号
• 在弹出的服务器类型列表中选中Apache Tomcat v9.0，点击下一步
• 选择本地Tomcat 9的根目录（即包含bin、lib文件夹的父级目录），Linux环境下需确保该目录及lib子目录对当前用户有读权限，避免IDE无法读取jar包
• 配置完成后打开项目的pom.xml，将servlet相关依赖的scope设置为provided，示例配置如下：

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

• 右键点击项目，选择「Add Server Runtime」，选中刚才配置的Tomcat 9运行时，重启Java语言服务即可解决@WebServlet等类无法识别的问题

二、Eclipse同步配置方法 #

核心逻辑和VSCode完全一致，关联Tomcat根目录为运行时后绑定到对应项目即可：

• 打开Eclipse路径：「Window」-「Preferences」-「Server」-「Runtime Environments」
• 点击「Add」，选择「Apache Tomcat v9.0」，下一步选择本地Tomcat 9的根目录，确认保存
• 右键点击目标项目，依次选择「Properties」-「Targeted Runtimes」，勾选刚才添加的Tomcat 9运行时，点击应用生效
• 同样需确认项目pom.xml中servlet相关依赖的scope为provided，避免jar包冲突

底层逻辑说明 #

Server Runtime的作用是给IDE提供运行环境自带类库的映射，覆盖编译、打包、运行全周期：

• 编译期：IDE自动将Runtime对应Tomcat lib目录下的所有jar包加入项目编译类路径，解决类识别异常问题
• 打包期：provided scope会告知Maven无需将servlet等依赖打入最终war包，避免和Tomcat自带jar包冲突
• 运行期：Tomcat加载自身lib目录下的jar包运行项目，和编译期使用的类版本完全一致，消除版本冲突、类NotFound等运行时故障

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