跳转至

开发环境就绪

极速启动

在现代软件工程中，配置环境不应成为拦路虎。根据课程“不纠结手动配置”的原则，本课程提供“一键式集成开发包”，助你跳过下载外网资源慢、版本冲突等“新手墙”，实现 30 分钟内进入代码编写状态。

📦 资源下载

请先下载教师提供的 JavaWeb 实战开发集成包 (2025版)。

点击下载课程集成包

集成包清单：

  • JDK: Alibaba Dragonwell 17 (信创标准 JDK)
  • Build Tool: Apache Maven 3.9.11
  • 版本控制VCS: Git 2.52.0 (64-bit)
  • Web Server: Apache Tomcat 9.0.113 (用于Web底层原理实验)
  • IDE: IntelliJ IDEA 2025.2.5 (免安装旗舰版)

建议目录结构

为了避免路径空格带来的莫名其妙的报错，建议在 D 盘新建 Dev 文件夹，将所有工具解压到此： D:\Dev\Java、D:\Dev\Maven、D:\Dev\Idea 等。

☕ 第一步：JDK 安装与验证

本课程采用 Alibaba Dragonwell，这是 OpenJDK 的下游版本，也是国内信创环境的主流选择。

  1. 解压：将 dragonwell-17 解压到 D:\Dev\Java\dragonwell-17。
  2. 配置环境变量：
    • 新建系统变量 JAVA_HOME -> 值：D:\Dev\Java\dragonwell-17
    • 编辑 Path 变量 -> 新建 -> %JAVA_HOME%\bin
  3. 验证：打开 CMD 输入 java -version，出现 "Alibaba Dragonwell" 字样即成功。 
    1
2
3
4
5
    java -version
# 输出示例：
# openjdk version "17.0.17" 2025-10-21
# OpenJDK Runtime Environment (Alibaba Dragonwell Standard Edition)-17.0.17.0.18+9-GA (build 17.0.17+9)
# OpenJDK 64-Bit Server VM (Alibaba Dragonwell Standard Edition)-17.0.17.0.18+9-GA (build 17.0.17+9, mixed mode, sharing)

🦁 第二步：Maven 极速配置

Maven 是 Java 项目的“管家”。我们使用预配置版本以加速依赖下载。

  1. 解压：将 apache-maven-3.9.11.zip 解压到 D:\Dev\Maven。
  2. 配置环境变量（这一步不做，命令行无法识别 mvn）：
    • 新建系统变量 MAVEN_HOME -> 值：D:\Dev\Maven\apache-maven-3.9.11
    • 编辑 Path 变量 -> 新建 -> %MAVEN_HOME%\bin
  3. 检查镜像配置： 打开 conf/settings.xml，确认已包含阿里云镜像（集成包已预配，确认即可）： 
    1
2
3
4
5
6
    <mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>
  4. 验证：CMD 输入 mvn -v，显示 Maven 版本号即成功。 
    1
2
3
4
5
6
7
    mvn -v
# 输出示例：
# Apache Maven 3.9.11 (3e54c93a704957b63ee3494413a2b544fd3d825b)
# Maven home: D:\Dev\Maven
# Java version: 17.0.17, vendor: Alibaba, runtime: D:\Dev\Maven\dragonwell-17.0.17.0.18+9-GA
# Default locale: zh_CN, platform encoding: GBK
# OS name: "windows 11", version: "10.0", arch: "amd64", family: "windows"

🐱 第三步：Tomcat 与 Git 配置

这两款工具是 Web 开发的基石。

1. Tomcat (Web 服务器)

虽然 Spring Boot 内置了 Tomcat，但在学习 Servlet 底层原理 章节时，我们需要独立的 Tomcat。 * 解压：将 apache-tomcat-9.0.113.zip 解压到 D:\Dev\Tomcat 即可，暂无需配置环境变量。

2. Git (版本控制)

  • 安装：运行 Git-2.52.0-64-bit.exe，一路点击 "Next" 直到安装完成。
  • 自报家门 (关键)： Git 需要知道“你是谁”才能记录提交。打开 CMD 或 Git Bash，执行以下命令： 
    1
2
    git config --global user.name "你的姓名"  # 例如: ZhangSan
git config --global user.email "你的邮箱" # 例如: zs@wtbu.edu.cn
  • 验证：CMD 输入 git --version。 
    1
2
3
    git --version
# 输出示例：
# git version 2.52.0.windows.1

💻 第四步：IntelliJ IDEA 最佳实践

IntelliJ IDEA 是目前地表最强的 Java IDE。

关于版本与授权：如何免费使用？

现在不再有单独的“社区版”安装包了，所有版本已经合并为一个“统一版”。集成包中提供的是 ideaIU (旗舰版)。

它的工作机制如下：

  1. 30天全功能试用：安装后，它通常会给你 30 天的旗舰版（Ultimate）试用体验。
  2. 永久免费兜底：试用期结束（或过期）后，你不需要付费。软件会自动锁定高级功能（如 Database 工具、Spring Initializr 向导），但保留所有核心功能（即以前社区版的所有功能：Java、Kotlin 开发等）。此时它就变身为“免费版”，你可以永久免费使用下去。
  3. 🎓 最佳方案 (推荐)：建议使用你的 edu.cn 学生邮箱 申请 JetBrains 免费教育许可证，登录后即可解锁 Ultimate 版的所有高级功能，享受最完整的 Spring Boot 开发体验。

1. 安装与初始化

  1. 解压 ideaIU-2025.2.5.win.zip 到 D:\Dev\Idea。
  2. 进入 bin 目录，找到 idea64.exe，右键 -> 发送到桌面快捷方式。
  3. 双击启动，如果提示激活，可选择 "Start Trial" (试用) 或直接 "Log In" (使用学生账号登录)。

2. 全局配置 (关键!)

在 IDEA 欢迎界面（不要打开项目），点击 Customize -> All settings... 进行全局设置，这样以后新建项目都不用重复配置：

  • Maven 设置：
    • 搜索 "Maven"。
    • Maven home path: 选择 D:/Dev/Maven/apache-maven-3.9.11。
    • User settings file: 勾选 Override，选择 D:/Dev/Maven/.../conf/settings.xml。
  • JDK 设置：
    • 搜索 "Project Structure" (或 SDK)。
    • 在 Platform Settings -> SDKs 中，点击 +，添加你的 Dragonwell JDK。

3. 安装必备插件 (Plugins)

IntelliJ IDEA 的强大离不开插件生态。为了统一开发规范，请务必安装以下插件。

🚀 快速安装指南：

先在欢迎界面点击 Plugins（或在项目中按快捷键 Ctrl + Alt + S 打开设置 -> Plugins），然后选择以下一种方式：

由于校园网可能不稳定，强烈建议使用此方式安装教师提供的离线包。

  1. 点击顶部的齿轮图标 ⚙️。
  2. 选择 Install Plugin from Disk... (从磁盘安装)。
  3. 导航到课程集成包的 Plugins 文件夹。
  4. 选中对应的 .zip 或 .jar 文件，点击 OK。
  1. 点击顶部的 Marketplace (市场) 标签。
  2. 在搜索框输入插件名称（如 Lombok）。
  3. 找到对应的插件，点击绿色的 Install 按钮。
  4. 等待下载进度条完成。


✅ 必装插件清单：

插件名称 (搜英文名) 核心作用 为什么必须装？
TONGYI Lingma AI 编程助手 课程核心工具。 阿里通义灵码（也可选 Qoder），它是你的 AI 结对编程伙伴，负责解释代码和生成单元测试。
MyBatisX 框架增强 开发效率神器。 它在 Mapper 接口和 XML 配置文件之间加了“小鸟图标”，点击即可互相跳转，不再需要全屏找代码。
Translation 翻译工具 新手救星。 遇到英文报错看不懂？选中文字 -> 右键 Translate，原地显示中文翻译。

避坑提示

  • 重启生效：插件安装完成后，IDE 右下角通常会提示 Restart IDE，必须重启软件后插件功能才会激活。
  • 版本兼容：如果你自己下载插件，请务必注意插件版本要与 IDEA 版本（2025.2）匹配，否则无法安装。使用集成包里的文件可避免此问题。

🔌 第五步：配置信创数据库环境 (openGauss)

本课程核心数据库为 openGauss。根据实训室电脑硬件配置及网络环境的不同，我们将采用以下三种方式之一。请根据老师当堂的指示选择对应模式。

适用场景：网络通畅，无需本地安装，通过校园内网直接连接。

  • Host (主机)：见班级群公告（例如 10.50.xx.xx）
  • User/Password：通常为 你的学号 / 初始密码

适用场景：教室电脑性能较好（内存≥16G），使用包含 openGauss 的信创 OS 镜像。

  1. 请使用 VMware 打开老师分发的 Sinnovation-Env.ova 镜像。
  2. 启动虚拟机，在终端输入 ip addr 查看 IP。
  3. Host (主机)：虚拟机的 IP 地址（例如 192.168.xxx.xxx）

适用场景：极客模式，电脑已安装 Docker Desktop，追求秒级启动。

  1. 在终端执行老师提供的 docker run 启动命令。
  2. Host (主机)：localhost 或 127.0.0.1


🔗 IDEA 连接步骤 (通用操作)：

无论采用上述哪种模式，在 IDEA 中的配置步骤是一致的：

  1. 打开 IDEA 右侧侧边栏的 Database 面板。
  2. 点击 + 号 -> Data Source -> PostgreSQL (openGauss 完美兼容 PG 协议)。
  3. 填写连接参数：
    • Host / User / Password：填入上方你所选模式对应的参数。
    • Database: 默认为 postgres 或老师指定的库名。
  4. 点击 Test Connection。
    • 如果显示绿色的 Succeeded，恭喜你，你的代码已经成功连上了国产信创数据库！

🧪 验证一切是否就绪

创建一个最简单的 Spring Boot 项目来测试环境（或者直接使用实验1提供的 demo-start 工程）。

  1. 新建项目：生成器 - Spring Boot。
  2. 依赖选择：Spring Web, Lombok。
  3. 编写代码： 
    1
2
3
4
5
6
7
    @RestController
public class HelloController {
    @GetMapping("/hello")
    public String say() {
        return "Hello Dragonwell! AI is ready!";
    }
}
  4. 运行：点击 Run。
  5. 访问：浏览器打开 http://localhost:8080/hello。

通关标志

如果你能在浏览器看到 "Hello Dragonwell! AI is ready!"，并且你的 IDEA 右侧边栏能唤出 AI 助手对话框，那么恭喜你——你的环境配置已达满分！

下一步：学习 Maven 与 Git 工程化 >>