Local Tomcat Launcher
VSCode 中快速启动/停止/重启本机 Tomcat，支持 Maven 编译和热加载。
功能特性
- 🚀 一键启动 — 内置 Tomcat 9，无需额外安装 Tomcat
- 🛑 即时停止 — 强制终止进程，立即释放端口
- 🔄 重启部署 — 清除旧配置 + 释放端口 + 重新 Maven 编译 + 启动
- 🔥 热加载 — 文件变更自动增量编译 + 同步，无需重启
- 📂 资源同步 — JSP、配置文件变更后自动同步到部署目录
- 📊 日志输出 — Tomcat 日志（catalina、localhost）实时输出到 VSCode 输出通道
- ☕ JDK 自动识别 — 自动使用 redhat.java 配置的 JDK 版本启动 Tomcat
- ⚙️ 灵活配置 — 支持自定义端口、contextPath、VM 参数、指定外部 Tomcat
建议
关闭java.autobuild,插件自带了增量更新
前置条件
| 条件 |
说明 |
| VSCode |
>= 1.85.0 |
| redhat.java |
>= 1.51.0（VSCode 扩展市场安装） |
| 操作系统 |
仅支持 Windows |
| 项目类型 |
单模块 Maven WAR 项目 |
| Maven |
已安装，命令行可访问 mvn |
快速开始
- 在 VSCode 中打开一个 Maven Web 项目（包含
pom.xml）
- 编辑器右上角出现三个紧密排列的按钮：▶ 启动、■ 停止、↻ 重启
- 点击 ▶ 启动，输出通道立即弹出，等待编译和启动完成
- 浏览器访问
http://localhost:8080/dev 查看项目
- 修改
src/main/java、src/main/resources、src/main/webapp 下的文件保存后，变更自动热加载
配置项
在 VSCode 设置中搜索 support.tomcat：
| 配置项 |
类型 |
默认值 |
说明 |
support.tomcat.home |
string |
"" |
Tomcat 安装路径（空则使用内置 Tomcat 9） |
support.tomcat.port |
number |
8080 |
HTTP 发布端口 |
support.tomcat.debugPort |
number |
5005 |
Debug 端口（JPDA） |
support.tomcat.contextPath |
string |
"dev" |
部署名称 / contextPath |
support.tomcat.vmOptions |
string |
"" |
Tomcat 启动 VM 参数 |
使用指南
启动
首次点击启动时，插件会自动：
- 从内置资源复制 Tomcat 9 到插件存储目录
- 执行
mvn compile war:exploded 编译项目
- 以 JPDA debug 模式启动 Tomcat（支持 HotSwap）
- 将项目部署为 Exploded WAR
再次启动时，如果已有编译输出则直接启动（跳过 Maven 编译）。
点击启动按钮后，输出通道会立即弹出，无需等待编译完成即可看到日志。
JDK 版本
Tomcat 启动时自动使用 redhat.java 扩展配置的 JDK，查找优先级：
java.configuration.runtimes 中 default: true 的路径java.jdt.ls.java.homejava.home（已弃用）- 系统
JAVA_HOME / JRE_HOME 环境变量
停止
点击停止按钮，插件调用 taskkill /F /T /PID 强制终止 Tomcat 进程树。
重启
点击重启按钮，插件会：
- 强制终止 Tomcat 进程
- 释放 HTTP 和 Debug 端口
- 清空 CATALINA_BASE 配置目录和 Maven target 目录
- 重新执行 Maven 全量编译
- 启动 Tomcat
热加载
插件通过 FileSystemWatcher 监听文件变更，实现自动热加载。三个独立监听器分别负责不同路径：
监听器一：src/main/**
| 文件路径 |
处理方式 |
防抖 |
src/main/java/**/*.java |
仅调用 JDT 增量编译，不同步（编译产出的 .class 由 target/classes 监听器负责同步） |
1s |
src/main/resources/**/* |
同步到部署目录 WEB-INF/classes |
1s |
src/main/webapp/**/* |
同步到部署目录根 |
1s |
监听器二：target/classes/**
| 文件路径 |
处理方式 |
防抖 |
target/classes/**/* |
立即同步到部署目录 WEB-INF/classes 对应位置 |
无 |
监听器三：pom.xml
| 文件路径 |
处理方式 |
防抖 |
pom.xml |
Maven 重新编译 → 更新部署目录 WEB-INF/lib |
5s |
防抖与去重机制：
- pom.xml 变更：5 秒内多次变更只处理一次
- java/resources/webapp 变更：1 秒内多次变更批量处理，同一文件只保留最新操作
- target/classes 变更：无防抖，立即逐文件同步
文件夹删除：
删除 src/main/resources、src/main/webapp 或 target/classes 下的文件夹时，部署目录中对应的文件夹也会同步删除。
按钮防护：
启动、停止、重启三个按钮加入防连续点击保护，任意一个操作执行期间，其他按钮点击会被忽略。
src/test/、.idea/、.vscode/ 等目录下的文件变更不会触发热加载。
输出通道
插件创建名为 tomcat 的输出通道，实时显示：
- Maven 编译日志
- Tomcat 启动/运行/停止日志（stdout/stderr）
- localhost 应用错误日志（通过 logging.properties 配置输出到控制台）
- JDK 路径信息（
[JRE_HOME] 前缀）
- 热加载操作日志
常见问题
Q: 插件不出现按钮？
A: 检查是否满足激活条件：Windows 环境、redhat.java >= 1.51.0、项目包含 pom.xml。
Q: 端口被占用？
A: 更改 support.tomcat.port 配置项，或点击重启按钮自动释放端口。
Q: HotSwap 不生效？
A: 仅方法体修改支持 HotSwap，新增方法/字段等结构性变更需点击重启。
Q: 能否使用外部 Tomcat？
A: 配置 support.tomcat.home 指向已安装的 Tomcat 目录即可。
Q: Tomcat 用的 JDK 不对？
A: 插件自动读取 java.configuration.runtimes 中 default: true 的 JDK 路径。在 VSCode 设置中配置 java.configuration.runtimes 指定 JDK 版本即可。
Q: Maven 编译输出乱码？
A: 插件已设置 JAVA_TOOL_OPTIONS=-Dfile.encoding=UTF-8，Maven 和 Tomcat 输出均使用 UTF-8 编码。
许可证
MIT
