VSCode本身不解析JSP，必须通过Community Server Connector插件启动Tomcat实例，将JSP文件部署至webapps/目录或通过Add Deployment添加，调试需针对编译后的Servlet而非JSP源码。
VSCode 本身不解析 JSP，调试必须走 Tomcat 容器；直接点“运行”或“F5”不会生效，必须通过插件启动完整 Tomcat 实例，并确保 JSP 文件放在正确部署路径下。
Tomcat for Java 插件已过时，改用 Community Server Connector
旧版 Tomcat for Java 插件自 2023 年起停止维护，VSCode 启动后常报 Unable to create the server: Extension backend error。现在官方推荐使用 Community Server Connector（含 Tomcat、Jetty、WildFly 支持）。
安装后，在侧边栏点击 SERVERS → + Add Server → 选择 Apache Tomcat → 指向你本地解压后的 Tomcat 根目录（如 /opt/tomcat 或 C:\apache-tomcat-10.1.33）。
关键检查点：
- 确保
CATALINA_HOME环境变量未被设为该路径（插件会自动识别，设了反而可能冲突） - Tomcat
bin目录下必须有catalina.sh（Linux/macOS）或catalina.bat（Windows） - 若提示 “JDK version mismatch”，检查项目级 JDK 配置：在项目根目录下
.vscode/settings.json中显式指定"java.jdt.ls.java.home"，不要依赖全局设置
JSP 文件必须部署到 Tomcat 可扫描的路径，不是随便放一个文件夹就能访问
VSCode 不是传统 IDE，没有内置 WebContent 或 Deployment Assembly 概念。插件部署行为取决于你如何组织项目结构和是否启用自动部署。
两种可靠方式：
-
手动部署：把整个 Web 应用目录（含
WEB-INF/、index.jsp）复制进 Tomcat 的webapps/子目录（如webapps/myapp/），然后在 SERVERS 面板右键该服务器 →Start，访问http://localhost:8080/myapp/index.jsp -
插件自动部署：在 SERVERS 面板中右键你的 Tomcat 实例 →
Add Deployment→ 选择含WEB-INF/web.xml或META-INF/MANIFEST.MF的目录或.war包。插件会将其复制到临时部署路径（通常是~/.vscode/extensions/adashen.vscode-tomcat-*/workspaceStorage/.../tomcat-work），并热加载
常见错误：HTTP Status 404 多因 JSP 文件没进 webapps/xxx/ 或子目录下，或路径名含空格/中文导致 Tomcat 拒绝加载。
调试 JSP 本质是调试其编译后的 Servlet，断点要打在生成的 Java 文件里
JSP 第一次请求时会被 Tomcat 编译为 .java 文件，再编译成 .class，位置通常在 work/Catalina/localhost/xxx/org/apache/jsp/。VSCode 默认不显示这些目录，也无法直接在 .jsp 上设断点生效。
可行做法：
- 在 JSP 中插入
<% System.out.println("break here"); %>，配合 Tomcat 日志（logs/catalina.out）定位执行流 - 对背后的 Servlet 类（如处理表单提交的
LoginServlet.java）设断点——这才是真正可调试的 Java 代码 - 若坚持调试 JSP 行为逻辑，需开启 Tomcat 的
mappedFile参数（在conf/web.xml的<servlet>块中加<init-param><param-name>mappedFile</param-name><param-value>true</param-value></init-param>），让编译出的.java保留原始 JSP 行号映射，再手动将work/...路径加入 VSCode 的sourcePaths（需修改launch.json）
注意：mappedFile=true 仅用于开发，生产环境禁用；且每次重启 Tomcat 后 work/ 清空，路径会变，不可持久化调试。
端口、编码与 classpath 错误是最常卡住新手的三类问题
看似能启动，但浏览器打不开或乱码，大概率不是代码问题：
-
Address already in use: bind：8080 被占用，改conf/server.xml里的Connector port="8080"为 8081 或其他；也可在 SERVERS 面板中右键 Tomcat →Configure Server→ 修改端口 - JSP 页面中文显示为 ：确认
web.xml中<page-encoding>或 JSP 顶部<%@ page contentType="text/html;charset=UTF-8" %>已声明；同时检查 Tomcat 的conf/logging.properties是否限制了控制台输出编码 -
ClassNotFoundException或 EL 表达式不解析：检查WEB-INF/lib/下是否有jstl.jar和standard.jar（Tomcat 10+ 需用jakarta.servlet.jsp.jstl替代）；Maven 项目则确认pom.xml中 scope 是provided还是compile
真正麻烦的从来不是“怎么配”，而是 Tomcat 启动日志里那几行被刷过去的警告——比如 SEVERE [main] org.apache.catalina.core.StandardContext.startInternal One or more Filters have failed to start，这种往往意味着 web.xml 语法错或 filter 类路径不对，得翻 logs/catalina.out 最后 20 行才能定位。
