刚开始接触Java Web开发的新手,往往都会在第一步环境搭建环节碰到各类问题,不管是工具版本不匹配、配置过程出错还是服务器没法正常启动,都会大大耽误大家的学习进度。
这篇教程专门适配零基础小白,全程不用复杂表格,会一步步带着大家完成JDK环境配置、IDEA工具安装、Tomcat服务器部署,还会讲解Java Web项目的创建与运行方法,只要跟着流程操作就能一次成功,新手直接照搬步骤就可以。
一、开发前必备工具与版本说明
搭建Java Web开发环境,最关键的就是让各类工具版本互相适配,避免后期出现各种莫名其妙的运行报错,这里更建议新手选用稳定好用的版本,没必要刻意追求最新版本。
- JDK:推荐JDK8、JDK11(这两个都是长期维护版,兼容效果最好,也是企业里最常用的版本)
- IntelliJ IDEA:优先用旗舰版,社区版没办法直接配置Tomcat做Web开发,新手用旗舰版操作起来更省事
- Tomcat:推荐Tomcat9、Tomcat10,和JDK8、JDK11适配性极高,配置步骤简单,运行时也很少出问题
大家一定要留意,所有开发工具都要安装在不带中文、没有空格的路径下,比方说D:\Environment\jdk、D:\Environment\tomcat,一旦路径带有中文,就很容易出现配置失效、项目运行不起来的情况。
二、JDK安装与环境变量配置
不管是做Java开发,还是让Tomcat正常运转,都离不开JDK环境,这一步是整个搭建流程的基础,一定要先完成这部分操作。
1. JDK下载与安装
大家直接去Oracle或者OpenJDK官网,下载对应版本的JDK安装包,双击后全程按照默认步骤安装就行,记得把安装路径改成之前说的无中文路径,安装结束后找到JDK所在文件夹,留着后续使用。
2. Windows系统环境变量配置
右键此电脑打开属性,找到高级系统设置后点击环境变量,接下来我们要配置三个核心的系统变量,具体步骤如下。
首先新建名为JAVA_HOME的系统变量,变量值直接填写JDK的安装根目录,举个例子D:\Environment\jdk1.8.0_391。
接着新建名为CLASSPATH的系统变量,变量值输入.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar,开头的句号和分号一定不能漏掉。
最后找到系统变量里的Path,双击打开编辑页面,新添加两条路径,分别是%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin。
3. 验证JDK配置是否成功
同时按下Win和R键,输入cmd打开命令运行窗口,接着依次输入下方两条命令做校验。
java -version
javac -version
要是命令行能正常显示对应的JDK版本,就说明配置成功了,如果提示不是内部命令,大家回头检查路径和变量名称,大概率是路径填写出错了。
三、IntelliJ IDEA安装与基础配置
IDEA是当下Java开发最常用的编程工具,功能齐全操作也便捷,这篇教程就以旗舰版为基础给大家讲解。
1. IDEA下载安装
前往JetBrains官网,下载最新版的IDEA旗舰版安装包,双击开始安装流程,安装过程中有两个地方需要大家留意。
- 安装路径同样要选不带中文、没有空格的文件夹
- 安装设置里,勾选创建桌面快捷方式、关联.java文件,剩下的选项保持默认就可以
2. IDEA首次启动配置
安装完成后打开IDEA,首次使用选择不导入原有配置,再按照提示完成激活,学生可以申请免费认证,也可以选择正版订阅使用。
进入软件主界面后,先完成基础设置,点击File再打开Settings,进入设置页面后配置项目默认的JDK。
依次找到Build, Execution, Deployment→Build Tools→Gradle→Gradle JDK,选中之前配置好的JDK版本,再把Project Structure里的SDK也改成同一版本,保证整个软件使用的JDK保持一致。
四、Tomcat下载与本地配置
Tomcat是一款小巧好用的Java Web服务器,主要用来运行Web项目,不需要专门安装,解压之后就能直接使用。
1. Tomcat下载
打开Apache Tomcat官网,找到下载板块,选择对应的Tomcat版本,更推荐9.x系列,下载Windows系统对应的zip压缩包,不用下载安装版,解压版使用起来更加灵活。
2. Tomcat解压与目录说明
把下载好的压缩包解压到提前准备好的无中文路径下,比方说D:\Environment\apache-tomcat-9.0.85,大家要记好几个核心文件夹的用处。
- bin:存放服务器开启、关闭的运行脚本
- conf:存放核心配置文件,后期可以修改端口、连接池等设置
- webapps:项目部署文件夹,把Web项目放进去就能运行
- logs:服务器运行日志,出现报错时可以查看日志找问题
3. 测试Tomcat本地启动
打开Tomcat里的bin文件夹,找到startup.bat文件双击运行,只要窗口弹出运行日志、没有报错且不会自动关闭,就说明Tomcat本身可以正常使用。
打开浏览器输入http:// localhost: 8080,能正常打开Tomcat默认首页,就说明Tomcat本地配置完毕,如果端口被占用,可以在conf/server.xml文件里修改端口号。
五、IDEA集成Tomcat并创建Web项目
这一步是整个流程的核心,把Tomcat和IDEA绑定在一起,就能实现项目一键启动、在线调试的功能。
1. IDEA关联本地Tomcat
打开IDEA,按照顺序点击File→Settings→Build, Execution, Deployment→Application Servers。
点击左上角的加号,选择Tomcat Server,在弹出的窗口里点击Browser,选中之前解压好的Tomcat文件夹,IDEA会自动识别Tomcat版本,点击Apply再点OK,就能完成Tomcat与IDEA的绑定。
2. 创建Java Web项目
回到IDEA主界面,点击New Project,就能开始创建Web项目,具体设置如下。
- 左侧菜单栏选择Jakarta EE,旧版本里叫做Java EE
- 勾选Web Application,模板选择普通的Web项目模板
- 设置好项目名称和存储路径,依旧要避开中文和空格
- Project SDK选择提前配置好的JDK,Java EE版本和Tomcat对应,Tomcat9匹配Java EE8
点击Next再点击Create,等待项目加载完成,IDEA会自动生成标准的Web项目文件夹结构。
3. 配置Tomcat运行环境
项目创建完成后,点击IDEA右上角的Add Configuration,也可以点击Edit Configurations,开始设置服务器运行参数。
首先点击左上角加号,下拉找到Tomcat Server并选择Local,新建本地Tomcat运行配置项。
然后在Server选项卡中,自定义一个配置名称,比如Tomcat9,Application Server选择之前绑定的Tomcat,HTTP端口默认8080,勾选After launch,让服务器启动后自动打开浏览器。
紧接着切换到Deployment选项卡,点击右上角加号选择Artifact,选中项目对应的war exploded,这个模式适合开发使用,修改代码后不用重启服务器就能生效。
最后设置项目访问路径Application context,更建议改成/,点击Apply再点OK,所有配置就全部完成了。
六、项目启动与运行测试
所有配置结束后,点击IDEA右上角的绿色运行按钮,就能启动Tomcat服务器。
等待控制台打印出启动成功的日志,IDEA会自动打开默认浏览器,访问项目默认的index.jsp页面,页面能正常展示,就说明整套Java Web开发环境彻底搭建完成。
七、常见问题排查
- Tomcat启动闪退:大多是JDK环境变量配置出错,或者Tomcat和JDK版本不兼容,回头重新检查JDK配置细节即可。
- 8080端口被占用:打开Tomcat/conf/server.xml文件,找到Connector port="8080",把8080改成8081、8090这类没被占用的端口就行。
- IDEA里找不到Tomcat Server:先确认自己装的是IDEA旗舰版,社区版没有这个功能,同时检查Application Servers的配置是否正确。
- 项目访问显示404:检查Deployment里的Artifact有没有添加成功、项目访问路径是否对应、项目文件夹结构是否完整。
八、总结
Java Web环境搭建主要分为三步,先配置好JDK环境,再解压Tomcat,最后把Tomcat和IDEA绑定,只要工具版本适配、路径规范,基本不会出现问题。
环境搭建完毕后,就能正式开启Java Web开发学习,后续编写Servlet、JSP、SSM框架项目,都能直接使用这套环境!