VSCode本身不解析JSP，必须通过Community Server Connector启动Tomcat容器部署并运行，调试需针对编译后的Servlet而非.jsp源码；旧版Tomcat for Java插件已停更，须卸载并改用Community Server Connector，且项目级JDK须≥17、server.xml需手动配置<context>指定绝对路径的docBase。
VSCode 本身不解析 JSP，也**不能直接运行或调试 .jsp 文件**。所有 JSP 请求必须经由 Tomcat 容器处理，断点只能打在编译后的 Servlet（.java 或 .class）上，不是 index.jsp 源码里。
用 Community Server Connector 启动 Tomcat，别装 Tomcat for Java
旧版 Tomcat for Java 插件自 2023 年起已停止维护，现在点击 “Add Server” 会报错：Unable to create the server: Extension backend error。必须卸载它，改用 Community Server Connector（Red Hat 发布）。安装后重启 VSCode，侧边栏才会出现 SERVERS 面板——不是在 “Run and Debug” 里配 launch.json。
- 不要同时启用多个 Tomcat 相关插件，会冲突
- 确认插件状态：右键 SERVERS → “Add Server” → 能选 “Apache Tomcat” 才算成功
- 指向 Tomcat 根目录时，路径里不能含空格或中文（如
C:\Program Files\...会失败）
项目级 JDK 必须显式设为 ≥17，且路径要写死在 .vscode/settings.json
Community Server Connector 启动失败的第二大原因，是 JDK 版本不匹配。它要求 JDK ≥17，但 VSCode 往往读取错误的 JDK 路径——比如全局 PATH 是 JDK 17，但项目根目录下的 .vscode/settings.json 仍写着旧版本。
- 检查方式：按
Ctrl+Shift+P→ 输入Java: Configure Java Runtime→ 看 “Workspace JDK” 是否为 JDK 17+ - 强制指定（替换为你本地路径）：
{ "java.jdt.ls.java.home": "C:/Program Files/Java/jdk-17.0.2" } - 别只改用户级 settings.json；项目级配置优先级更高，且直接影响 Tomcat 启动逻辑
部署不是自动的，必须手动加 <context> 到 server.xml
Community Server Connector 启动的是“干净”的 Tomcat 实例，不会自动部署你的 Web 应用。它不像 IDEA 那样识别 src/main/webapp 或 target/*.war，必须手动编辑 conf/server.xml，在 <Host> 内插入 <context> 元素。
- Maven 项目（war 包）：
<context path="/myapp" docBase="D:/my-project/target/my-app.war" reloadable="true"/>
- 传统结构（含
WEB-INF/web.xml）：<context path="/myapp" docBase="D:/my-project/src/main/webapp" reloadable="true"/>
-
docBase必须是绝对路径；相对路径、带空格、含中文都会导致 404 或启动失败
调试 JSP 就是调试生成的 Servlet，断点不能打在 .jsp 上
JSP 第一次被请求时，Tomcat 才将其编译为 .java（位置通常在 work/Catalina/localhost/myapp/org/apache/jsp/），再编译成 .class。VSCode 默认不显示 work/ 目录，也无法在 index.jsp 上设有效断点。
- 真要调试，得等 Tomcat 启动并访问过一次 JSP 后，去
work/目录找对应.java文件，用 VSCode 打开并设断点 - 更实用的做法：把业务逻辑抽到 Java Bean 或 Servlet 里，在那里设断点，避开 JSP 编译链的不可控性
- 如果坚持调试 JSP 行为，记得开启
reloadable="true"，否则修改后需重启 Tomcat
最易被忽略的一点：JSP 文件名和路径里的空格、中文、大小写不一致，会导致 Tomcat 拒绝加载，直接返回 404，连日志都不报明显错误。建议全程用小写字母 + 连字符命名，部署前先用 ls -l 或 dir 确认路径完全匹配。
