Tomcat 是 Java Web 开发中最常用的 Servlet 容器。很多开发者在初次搭建环境时,常因配置遗漏导致项目无法运行。本文将系统讲解 Tomcat 的完整部署流程,涵盖从下载解压到主流 IDE 集成的关键步骤。
下载与安装
访问 Tomcat 官网下载对应版本,建议优先选择稳定版。解压后请确保路径中不包含中文或特殊字符,否则可能引发启动异常。
解压后的目录结构通常包含以下核心文件夹:
- bin:存放启动脚本(startup.bat/sh)和关闭脚本(shutdown.bat/sh)。
- conf:配置文件目录,如 server.xml、web.xml。
- lib:存放依赖的 JAR 包。
- logs:运行日志文件。
- temp:临时文件存储。
- webapps:默认部署目录,可放置 WAR 包或展开的项目。
- work:JSP 编译后的中间文件(.java/.class)。
启动与验证
启动前需确保已安装 JDK 并正确配置环境变量。若未配置 JAVA_HOME,启动时可能会报错提示缺少环境变量定义。
Windows 环境下,进入 bin 目录双击 startup.bat;Linux/Mac 则执行 startup.sh。启动成功后,浏览器访问 http://localhost:8080,若看到 Tomcat 欢迎页面即表示服务正常。默认端口为 8080,若被占用可在 conf/server.xml 中修改 Connector 的 port 属性。
也可通过命令行进入 bin 目录输入 startup 命令进行启动,观察控制台输出确认无报错。
配置环境变量
为了便于全局调用 Tomcat 命令,建议配置系统环境变量。
- 右键'此电脑'进入'属性',选择'高级系统设置'。
- 点击'环境变量',在系统变量区域新建变量。
- 变量名设为
CATALINA_HOME,变量值为 Tomcat 的安装根目录。 - 编辑 Path 变量,追加
%CATALINA_HOME%\bin。这样即可在任何目录下使用 Tomcat 相关命令。
IntelliJ IDEA 配置
IDEA 中集成 Tomcat 相对便捷,主要涉及服务器注册与运行配置两部分。
首先,进入 File -> Settings -> Build, Execution, Deployment -> Application Servers。点击加号选择 Tomcat Server,指向本地安装路径导入。若界面找不到该选项,可能是版本差异,可直接在 Run Configuration 中添加。
接着,点击右上角运行配置下拉框,选择 Edit Configurations。添加新的 Tomcat Server (Local),指定刚才导入的 Tomcat 路径。应用保存后,即可直接运行项目。
Eclipse 配置
Eclipse 的配置逻辑类似,需在偏好设置中注册 Runtime Environment。
打开 Window -> Preferences -> Server -> Runtime Environments,点击 Add 选择 Apache Tomcat,指定安装路径完成注册。
创建项目时,选择 Dynamic Web Project。注意新版 Eclipse 默认目录结构可能显示为 src/main/java,这不影响运行,但为了符合传统习惯,建议在 Content directory 中手动指定为 WebContent 或 webapp,并确保勾选 XML 支持。
测试环节,在项目下新建 index.jsp 文件,编写简单的 Hello World 代码。运行配置中选择已注册的 Tomcat 服务器,移除其他无关项目引用,确保部署目录正确。启动后访问对应地址,若能看到页面输出,说明环境配置完全成功。


