tomcat安装与环境变量配置教程及完整操作步骤
手把手教你在Windows系统中安装Apache Tomcat并配置关键环境变量。涵盖JDK验证、CATALINA_HOME设置及启动测试,确保Web服务器正常运行,适合Java初学者参考。
要在本地运行Java Web应用,Apache Tomcat是最常用的轻量级服务器。正确安装并配置环境变量,不仅能避免启动时的报错,还能让系统在任意目录下都能通过命令行调用Tomcat脚本。本教程将带你从零开始,完成下载、解压、变量配置到成功启动的全过程。

Apache Tomcat官方下载页面,选择Core下的zip格式安装包
在开始之前,请确保你的电脑中已经安装了JDK(Java Development Kit),因为Tomcat依赖Java运行环境。如果尚未安装,请先完成JDK的安装与配置。本教程以Windows 10/11系统和Tomcat 9为例,其他版本操作逻辑基本一致。
1. 下载并解压Tomcat
访问Apache Tomcat官方网站,进入Download页面。在左侧导航栏找到“Tomcat 9”或你需要的版本,点击核心分布下的“zip”链接进行下载。建议下载64-bit Windows zip版本,这样无需安装程序,解压即可使用,更加干净灵活。
下载完成后,找到一个非中文、无空格的路径进行解压,例如 D:\Program Files\Apache\tomcat9。解压后的目录结构应包含 bin、conf、lib、webapps 等文件夹。其中 bin 目录存放了启动和关闭服务器的脚本文件,是后续配置的重点。

1. 下载并解压Tomcat
2. 配置JAVA_HOME环境变量
Tomcat启动时需要知道JDK安装在哪里,因此必须配置 JAVA_HOME。右键点击“此电脑”,选择“属性”,进入“高级系统设置”,点击“环境变量”按钮。
在“系统变量”区域中,检查是否已有名为 JAVA_HOME 的变量。如果没有,点击“新建”,变量名输入 JAVA_HOME,变量值填入你的JDK安装根目录,例如 C:\Program Files\Java\jdk1.8.0_202。注意,路径应指向JDK文件夹本身,而不是其中的 bin 目录。如果已存在该变量,请确认其路径指向当前有效的JDK版本。

在系统变量中新建JAVA_HOME变量
配置完成后,点击确定保存。这一步确保了Tomcat能够调用正确的Java编译器及运行时环境。若未配置此项,启动Tomcat时通常会提示“Neither the JAVA_HOME nor the JRE_HOME environment variable is defined”。
3. 配置CATALINA_HOME环境变量
为了方便管理和在命令行中快速定位Tomcat,建议配置 CATALINA_HOME。同样在“系统变量”区域,点击“新建”。
变量名输入 CATALINA_HOME,变量值填入刚才解压的Tomcat根目录,例如 D:\Program Files\Apache\tomcat9。这个变量告诉系统Tomcat的主目录位置,许多第三方工具和脚本会依赖它来查找配置文件和库文件。
此外,为了能在CMD任意路径下直接运行启动脚本,可以将 %CATALINA_HOME%\bin 添加到系统的 Path 变量中。找到系统变量中的 Path,点击“编辑”,新建一条记录,输入 %CATALINA_HOME%\bin,然后一路点击确定保存所有设置。
4. 验证配置并启动服务
配置完成后,需要验证环境变量是否生效。按下 Win + R,输入 cmd 打开命令提示符。在窗口中输入 echo %JAVA_HOME% 和 echo %CATALINA_HOME%,回车后应分别显示你刚才设置的路径。如果显示的是变量名本身而非路径,说明配置未生效,需检查是否有拼写错误或未点击确定保存。
接下来尝试启动Tomcat。在命令行中输入 startup.bat 并回车,或者直接双击Tomcat目录下 bin 文件夹中的 startup.bat 文件。此时会弹出一个新的黑色控制台窗口,显示Tomcat的启动日志。

startup.bat运行后的控制台输出,显示启动成功
观察最后几行日志,如果出现 Server startup in [xxxx] ms 字样,说明启动成功。如果有大量红色报错或窗口瞬间关闭,通常是因为端口被占用或JDK路径配置错误。此时可检查 logs 目录下的 catalina.yyyy-mm-dd.log 文件获取详细错误信息。
5. 访问默认页面测试
打开浏览器,在地址栏输入 http://localhost:8080 并回车。如果看到Apache Tomcat的欢迎页面,包含版本信息和文档链接,即表示安装与配置完全成功。

浏览器访问localhost:8080显示的Tomcat首页
至此,Tomcat已准备就绪。你可以将开发好的WAR包放入 webapps 目录下,或通过IDEA、Eclipse等工具集成该Tomcat实例进行Java Web项目开发。如需停止服务,只需关闭那个黑色的控制台窗口,或在命令行运行 shutdown.bat。


































