tomcat 必须先独立启动成功（catalina.bat run 并访问 localhost:8080），再配置 vscode；仅装 extension pack for java 和 community server connector；maven 项目须符合标准 web 结构且 packaging 为 war；java 类修改后需手动 mvn compile + redeploy。
Tomcat 启动失败：先验证独立运行再进 VSCode
VSCode 本身不托管 Tomcat，所有“配置成功”的前提是 Tomcat 能脱离编辑器正常启动。跳过这步，90% 的后续问题（404、白页、ClassNotFoundException）都白调。
解压 apache-tomcat-*.zip 到纯英文路径（如 D:\tomcat），**别用 Windows Installer 版本**——它会静默注册服务、改注册表，路径难追踪、权限易出错。
打开终端，进入 bin 目录，执行：
catalina.bat run
看到类似 Server startup in [1234] ms 且浏览器能打开 http://localhost:8080 显示猫页，才算真正就绪。此时务必确认：
-
JAVA_HOME指向 JDK（不是 JRE），且%JAVA_HOME%\bin在PATH中 - Windows 下若提示“找不到或无法加载主类”，大概率是
JAVA_HOME指向了 JRE 或路径含空格/中文
插件选 Community Server Connector，别碰已弃用的 Tomcat for Java
VSCode 官方已停止维护 Tomcat for Java，插件市场里标“Deprecated”或“Use Community Server Connector instead”的，一律跳过。
只装这两个核心插件：
-
Extension Pack for Java（含语言支持、调试器、Maven 集成） -
Community Server Connector（Red Hat 维护，支持 Tomcat 9/10，可部署、启停、查看日志）
装完重启 VSCode。如果左下角没出现 SERVERS 面板，按 Ctrl+Shift+P → 输入 Services: Focus on Services View 手动唤出。
右键 SERVERS → Add Server → 选 Apache Tomcat → 填你本地解压路径（如 D:\tomcat）。端口默认 8080，别改；管理用户密码留空（除非你手动配过 conf/tomcat-users.xml）。
Maven 项目结构必须合规，否则 Community Server Connector 找不到 webapp
Community Server Connector 不识别“手工建的 src/webapp”或“缺 web.xml 的裸 Servlet”。它只认标准 Maven Web 结构：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
-
src/main/java：放HelloServlet.java等类 -
src/main/webapp：放index.html、WEB-INF/web.xml（即使空着也得有目录） -
pom.xml中<packaging>war</packaging>必须存在
创建新项目时，用命令行最稳：
mvn archetype:generate -DgroupId=com.example -DartifactId=myweb -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
生成后，在 VSCode 中用 File → Open Folder 打开 myweb 根目录。等 Maven 依赖下载完（状态栏显示 “Importing…” 消失），再右键 SERVERS 里的 Tomcat → Deploy → 选这个项目文件夹。
部署后，访问 http://localhost:8080/myweb。如果 404，检查：target/myweb 是否生成、webapps/myweb 下是否有 WEB-INF/classes 和 WEB-INF/lib；没有说明 Maven 编译失败或插件没生效。
热更新失效？别信“自动编译”，手动触发 mvn compile 才可靠
Community Server Connector 的“自动部署”只监听 src/main/webapp 下静态文件（HTML/CSS/JS）变更。Java 类修改后，它不会自动 javac + 复制 .class，也不会触发 mvn compile。
改完 HelloServlet.java 后，必须手动做两件事：
- 在 VSCode 终端执行
mvn compile（确保 class 文件生成到target/classes） - 右键 SERVERS → Tomcat →
Redeploy（或删掉webapps/myweb再Deploy）
想省事？加个 VSCode 任务（.vscode/tasks.json）：
{
"version": "2.0.0",
"tasks": [
{
"label": "mvn compile & redeploy",
"type": "shell",
"command": "mvn compile && echo 'redeploying...' && sleep 1"
}
]
}
然后按 Ctrl+Shift+P → Tasks: Run Task → 选它。比点鼠标快，也比等插件“自动”靠谱。
最常被忽略的一点：Tomcat 启动后，webapps 下的项目目录会被锁住。直接删文件可能失败，建议用 Redeploy 或先 Stop Server 再操作。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
