TomcatEE VSCode 扩展

一个 VSCode 扩展，用于管理 Apache Tomcat 服务器，提供基本的部署和调试功能。

English Documentation (英文文档) 可在 README.md 中查看

功能特性

核心功能

• Tomcat 实例管理 - 创建和管理 Tomcat 服务器实例
• 项目部署 - 部署 Maven/Gradle/Ant Web 项目到 Tomcat
• 热部署 - 文件变化时重新部署（需要手动触发）
• 调试支持 - 以调试模式启动 Tomcat，支持 JDWP
• Web 界面 - 基本的实例配置面板
• 端口管理 - 配置 HTTP、HTTPS 和调试端口
• 日志查看 - 查看 Tomcat 启动和运行日志

构建支持

• Maven 项目 - 单模块和多模块 Maven Web 项目
• Gradle 项目 - 基本的 Gradle Web 项目支持
• Ant 项目 - 简单的基于 Ant 的 Web 项目
• WAR 部署 - 部署预构建的 WAR 文件

调试功能

• 调试模式 - 启用调试端口启动 Tomcat
• VSCode 集成 - 基本的 launch.json 配置生成
• Java 8+ 支持 - 兼容现代 Java 版本

快速开始

1. 安装扩展

   • 在 VSCode 扩展中搜索 "TomcatEE"
   • 安装并重新加载 VSCode

2. 设置 Tomcat 实例

   • 打开命令面板 (Ctrl+Shift+P)
   • 运行 "TomcatEE: Create Instance"
   • 提供 Tomcat 安装路径和基本设置

3. 部署项目

   • 在 VSCode 中打开 Maven/Gradle Web 项目
   • 使用 TomcatEE 面板部署项目
   • 如需要，先构建项目

4. 启动和测试

   • 从面板启动 Tomcat 实例
   • 在浏览器中访问应用
   • 检查日志查看问题

5. 调试（可选）

   • 以调试模式启动 Tomcat
   • 在 Java 代码中设置断点
   • 使用 F5 连接 VSCode 调试器

系统要求

• VSCode 1.74.0 或更高版本
• Apache Tomcat 8.5+ 或 9.0+（用户提供）
• Java 8 或更高版本
• Maven 或 Gradle（用于构建项目）

支持的项目类型

单模块项目

• Maven Web 项目（WAR 打包）
• Gradle Web 项目（WAR 打包）
• 基本 Java Web 应用
• JSP/Servlet 应用

多模块项目

• Maven 多模块项目（基本支持）
• 简单的父子 POM 结构

调试支持

• Java 8+ 与 JDWP
• 基本断点调试
• 远程调试（手动配置）

配置

实例设置

• 端口: HTTP、HTTPS、调试端口（手动配置）
• JVM 选项: 基本内存和参数设置
• 路径: Tomcat 安装和 webapp 目录
• 调试: 启用/禁用调试模式

全局设置

• 默认路径: Tomcat 安装目录
• 构建工具: Maven/Gradle 可执行文件路径
• 浏览器: 打开应用的默认浏览器

常见问题

Q: 如何卸载扩展？ A: 在 VSCode 扩展面板中找到 TomcatEE，点击卸载按钮即可。

Q: 支持哪些 Tomcat 版本？ A: 支持 Tomcat 8.5+ 和 9.0+ 版本。

Q: 热部署是否支持自动触发？ A: 目前需要手动触发，后续版本可能会支持自动触发。

许可证

本项目采用专有许可证。详见 LICENSE 文件。

致谢

感谢以下项目和团队的支持：

• Apache Tomcat - 强大的 Java Web 服务器
• Visual Studio Code - 优秀的代码编辑器
• 开源社区 - 提供的各种工具和库支持

联系方式

如有任何问题或建议，欢迎联系开发团队：

• 📧 Email: cuiyongxu@gmail.com
• 🐛 问题报告: 请向开发团队报告