JSP 环境搭建完整流程

一、文档基础信息

一、文档基础信息

项目	内容
文档主题	JSP 环境搭建完整流程
核心工具版本	JDK 17、Apache Tomcat 8.5.15、Maven 3.6.3、IntelliJ IDEA 2025.1.3

二、环境搭建核心步骤

（一）前期准备：文件与 JDK 环境

1. 解压缩文件：需完成 2 个文件的解压缩操作，包含 JDK、Tomcat 等环境依赖文件。
2. JDK 环境变量验证：
   • 进入 “系统属性→高级→环境变量”，检查系统变量中是否包含C:\Program Files\javajdk-17\bin路径；
   • 确保%JAVA_HOME%\bin已配置到 Path 变量中，保证 JDK 可全局调用。

（二）Apache Tomcat 8.5.15 配置与验证

1. 启动 Tomcat：
   • 找到 Tomcat 解压目录（如 D:\apache-tomcat-8.5.15），进入bin文件夹；
   • (详情文件在我的另一篇文章tools分类下)↑个人数字生活必备工具箱：应对各种情况的实用资源汇总 | bracku blog
   • 双击startup.bat，弹出命令行窗口，若日志中出现 “17-Sep-2025 17:54:35.287 信息 [main] org.apache.catalina.startup.Catalina.start Server startup in 608 ms”（时间可能不同），表示启动成功，不可关闭命令行窗口。
2. 验证 Tomcat 服务：
   • 打开浏览器，在地址栏输入localhost:8080；
   • 若弹出 “Apache Tomcat/8.5.15” 欢迎页，说明 Tomcat 服务正常。
3. 关闭 Tomcat：
   • 需停止服务时，进入 Tomcat 的bin目录，点击shutdown.bat，关闭命令行窗口即可。

（三）Maven 3.6.3 配置

1. 文件目录准备：
   • 在 D 盘新建develop_tools文件夹，将解压后的 Maven（apache-maven-3.6.3）放入该目录。
   • 个人数字生活必备工具箱：应对各种情况的实用资源汇总 | bracku blog
2. Maven 环境变量配置：环境变量类型变量名变量值说明系统变量M2_HOMED:\develop_tools\apache-maven-3.6.3不含末尾的 “\bin”系统变量（Path）-D:\develop_tools\apache-maven-3.6.3\bin保留 “\bin”，用于调用 Maven 命令
3. Maven 验证：
   • 打开 CMD 命令行，输入mvn -v；
   • 若输出 “Apache Maven 3.6.3” 及相关版本信息，说明 Maven 环境配置成功。
4. Maven 本地仓库配置：
   • 在 D 盘新建common_tools文件夹，用于存储 Maven 依赖；
   • 进入 Maven 目录下的conf文件夹，用记事本打开settings.xml；
   • 找到<localRepository>标签，将路径改为D:/common_tools（覆盖默认路径），保存文件。

（四）IntelliJ IDEA 2025.1.3 配置与项目创建

1. IDE 中 Maven 配置：
   • 打开 IDEA，点击 “Customize→All settings”；
   • 进入 “Build, Execution, Deployment→Build Tools→Maven”；
   • 配置三项核心参数：
     • Maven home path：D:\develop_tools\apache-maven-3.6.3；
     • User settings file：D:\develop_tools\apache-maven-3.6.3\conf\settings.xml（勾选 Override）；
     • Local repository：D:\common_tools（勾选 Override）；
   • 点击 “Apply→OK”，重启 IDE 生效。
2. 项目目录与模块创建：
   • 在 E 盘新建workspace文件夹，用于存储代码文件；
   • IDE 中新建空项目，选择路径为 E:\workspace；
   • 新建 Maven 模块：
     • 模块名称：jsp03（因前期可能有项目，序号可调整）；
     • 选择生成器：Maven Archetype，模板为org.apache.maven.archetypes:maven-archetype-webapp；
     • JDK 版本：17（Oracle OpenJDK 17.0.12）；
     • 点击 “创建”，等待项目加载（pom.xml 显示无报错即为成功）。
3. IDE 中 Tomcat 配置：
   • 进入 “Settings→Build, Execution, Deployment→Application Servers”；
   • 点击 “+”，选择 “Tomcat Server”，配置参数：
     • 名称：Tomcat 8.5.15；
     • Tomcat 主目录：D:\apache-tomcat-8.5.15（需能看到 bin 目录，否则提示无效）；
   • 点击 “Apply→OK”，完成 Tomcat 服务器配置。
4. 项目部署配置：
   • 点击 “编辑配置”，添加 “Tomcat 服务器→本地（Local）”；
   • 配置部署信息：
     • 名称：jsp03（与模块名一致）；
     • 应用程序服务器：Tomcat 8.5.15；
     • 添加工件：选择 “jsp03:war exploded”（带 exploded 后缀）；
     • 应用上下文：修改为/jsp03（删除默认的 “_war_exploded” 后缀）；
   • 选择 “重新部署，更新类和资源”，点击 “Apply→OK”。

（五）部署验证与依赖添加

1. 部署验证：
   • 点击 IDE 中的 “运行” 按钮，启动 Tomcat 服务器；
   • 浏览器自动弹出或手动输入localhost:8080/jsp03/，页面显示 “Hello World!”，表示部署成功（跳红乱码不影响）。
2. 添加项目依赖：
   • 打开项目的 pom.xml 文件，在<dependencies>标签内添加依赖：

<!-- Java EE Servlet API -->
<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>
<!-- 单独引入 JSP API -->
<dependency>
    <!-- JSP API相关依赖配置 -->
</dependency>

点击 pom.xml 右上角 “同步更改”，完成依赖更新，至此 JSP 环境搭建全部完成。

如果以上步骤还有什么没懂的，参考我以下发的ppt（不一定文档是对的，详细内容在ppt里）