Community Server Connector是VSCode中配置Tomcat的唯一可行路径，必须卸载旧插件（如adashen.vscode-tomcat），仅保留Red Hat发布的该插件并重启；项目级JDK须显式设为≥17，通过.vscode/settings.json指定准确路径；部署需手动复制Web应用至webapps或右键Add Deployment；JSP调试需先触发请求生成index_jsp.java，再打开work目录设断点。
Community Server Connector 是唯一可行路径
旧版 Tomcat for Java 插件自 2023 年起已停止维护，现在点击 “Add Server” 卡住、报 Unable to create the server: Extension backend error，基本都是装错了插件。必须卸载所有 Tomcat 相关插件（尤其是 adashen.vscode-tomcat），只保留 Community Server Connector（发布者：Red Hat）。装完必须重启 VSCode，否则侧边栏不会出现 SERVERS 面板——这不是可选项，是功能入口的唯一位置。
项目级 JDK 必须显式设为 ≥17
VSCode 启动 Tomcat 失败的第二大原因，是项目实际用的 JDK 版本低于 17。即使终端里 java -version 显示的是 JDK 17，VSCode 可能仍读取了错误的路径。不要依赖全局 settings.json 或系统环境变量 CATALINA_HOME，它反而会干扰插件自动识别。
- 在项目根目录下确认存在
.vscode/settings.json - 手动写入准确路径：
"java.jdt.ls.java.home": "/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home"（macOS）或"java.jdt.ls.java.home": "C:\Program Files\Java\jdk-17.0.2"（Windows） - 按
Ctrl+Shift+P→ 输入Java: Configure Java Runtime，确认 “Workspace JDK” 显示的是你刚配的版本
部署不是“点一下就跑”，必须选对方式
Community Server Connector 默认只启动空 Tomcat，不会自动把 src/main/webapp 或 target/*.war 映射过去。所谓“自动部署”只是错觉，真实路径由你控制。
-
手动部署（推荐新手）：把整个 Web 应用目录（含
WEB-INF/和index.jsp）复制进 Tomcat 的webapps/myapp/，然后右键 SERVERS 面板里的 Tomcat 实例 →Start，访问http://localhost:8080/myapp/index.jsp -
插件部署（需结构合规）：右键 Tomcat 实例 →
Add Deployment，只能选含WEB-INF/web.xml或META-INF/MANIFEST.MF的目录或.war包；插件会把它复制到临时路径（如~/.vscode/extensions/redhat.vscode-community-server-connector-*/workspaceStorage/*/tomcat-work），不是webapps/ - HTTP 404 几乎全是路径问题：检查是否含空格/中文、
webapps下有没有对应子目录、浏览器 URL 是否漏了上下文路径（比如该访问/myapp/却直打/）
JSP 调试断点不生效？你根本没打对地方
VSCode 无法直接在 .jsp 文件上设有效断点。JSP 第一次被请求时，Tomcat 才将其编译成 Java 源码，位置在 work/Catalina/localhost/myapp/org/apache/jsp/ 下的 index_jsp.java。这个目录默认被 VSCode 隐藏，且不在工作区里。
立即学习“Java免费学习笔记（深入）”；
- 想调试，得先触发一次请求（浏览器打开页面），让 Tomcat 生成
.java和.class - 在 SERVERS 面板右键 Tomcat →
Open Server Configuration，找到work目录的真实路径（通常在 Tomcat 根目录下） - 用 VSCode 打开该
work目录（或把index_jsp.java拖进当前窗口），才能设断点——但注意：修改后不会热更新，必须重启 Tomcat - 真正稳定的调试方式，是把业务逻辑抽到 Servlet 或普通 Java 类里，JSP 只做展示层
最常被忽略的一点：Tomcat 启动成功 ≠ 你的 JSP 能访问。从 webapps 路径、JDK 版本、插件兼容性到断点位置，每个环节都可能静默失败。别信“配置完就能跑”，每一步都要验证输出和路径。
