Spring Boot 开发环境搭建和项目启动

1. JDK 的配置

Spring Boot 基于 Java 开发，因此首先需要正确配置 JDK。

1.1 在 IntelliJ IDEA 中配置 JDK

1. 打开菜单：File → Project Structure；
2. 左侧选择 SDKs；
3. 点击 + → Add JDK；
4. 在 JDK home path 中选择本地 JDK 安装目录（如 C:\Program Files\Java\jdk-17）；
5. 在 Name 中为该 JDK 自定义名称（如 JDK 17）；
6. 点击 OK 完成导入。

✅ 配置完成后，新建项目时即可选择该 JDK 作为 Project SDK。

1.2 在 Eclipse / STS 中配置 JDK

• 添加 JDK：
  Window → Preferences → Java → Installed JREs → Add...
• 设置编译器版本：
  Window → Preferences → Java → Compiler，确保 Compiler compliance level 与 JDK 版本一致。

2. Spring Boot 工程的构建

2.1 使用 IDEA 快速构建（推荐）

1. 打开 IDEA，选择 File → New → Project；
2. 左侧选择 Spring Initializr；
3. Project SDK 选择已配置的 JDK；
4. 点击 Next，填写项目基本信息：

• Group：公司/组织域名，如 com.itcodai
• Artifact：项目名称，如 course01
• Dependencies：勾选 Spring Web（用于构建 Web 应用）

5. 点击 Next → Finish，IDEA 将自动生成项目并下载依赖。

2.2 通过 Spring 官方网站构建

1. 访问 https://start.spring.io；
2. 填写 Group、Artifact、选择依赖（如 Spring Web）；
3. 点击 Generate 下载 ZIP 包；
4. 解压后，在 IDEA 中选择：
   File → New → Project from Existing Sources，导入项目；
5. Eclipse 用户可使用：
   File → Import → Existing Maven Projects 导入。

💡 官方构建方式适用于无网络插件支持的环境，但 IDEA 内置 Initializr 更便捷。

3. Maven 与编码配置

3.1 配置 Maven（加速依赖下载）

1. 打开 File → Settings → Build, Execution, Deployment → Build Tools → Maven；
2. 设置：

• Maven home directory：本地 Maven 安装路径；
• User settings file：指向 conf/settings.xml；

3. 在 settings.xml 中添加 阿里云镜像，大幅提升下载速度：

<mirrors>
  <mirror>
    <id>nexus-aliyun</id>
    <mirrorOf>*</mirrorOf>
    <name>Nexus aliyun</name>
    <url>https://maven.aliyun.com/repository/public</url>
  </mirror>
</mirrors>

⚠️ 注意：新版本阿里云仓库 URL 已更新为 https://maven.aliyun.com/repository/public。

3.2 配置项目编码为 UTF-8

避免中文乱码，务必统一编码：

• IDEA：
  File → Settings → Editor → File Encodings，将 Global Encoding、Project Encoding、Default encoding for properties files 全部设为 UTF-8。
  
• Eclipse：

1. Window → Preferences → General → Workspace → Text file encoding → UTF-8
2. Window → Preferences → General → Content Types → Text → Default encoding → UTF-8

4. Spring Boot 项目结构解析

创建成功后，项目结构如下：

course01/
├── src/main/java/          # Java 源代码（业务逻辑）
├── src/main/resources/     # 配置文件、静态资源、模板
│   ├── application.properties 或 application.yml
│   ├── static/             # 静态文件（CSS/JS/images）
│   └── templates/          # 模板文件（Thymeleaf等）
└── src/test/java/          # 单元测试代码

关键文件说明

• 启动类（如 Course01Application.java）：

@SpringBootApplication
public class Course01Application {
    public static void main(String[] args) {
        SpringApplication.run(Course01Application.class, args);
    }
}

• @SpringBootApplication 是核心注解，整合了自动配置、组件扫描等功能；
• 直接运行 main 方法即可启动内嵌 Tomcat 服务器。

5. 编写第一个 Controller 并测试

在 src/main/java/com/itcodai/course01/controller/ 下创建控制器：

package com.itcodai.course01.controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
@RequestMapping("/start")
public class StartController {
    @RequestMapping("/springboot")
    public String startSpringBoot() {
        return "Welcome to the world of Spring Boot!";
    }
}

启动与访问

1. 运行 Course01Application 的 main 方法；
2. 控制台显示 Tomcat started on port(s): 8080 表示启动成功；
3. 浏览器访问：
   http://localhost:8080/start/springboot

✅ 若看到页面输出 Welcome to the world of Spring Boot!，恭喜你，第一个 Spring Boot 应用运行成功！

修改默认端口

若需更改端口（如 8001），在 src/main/resources/application.yml 中添加：

server:
  port: 8001

若使用 application.properties，则写为：

server.port=8001

6. 总结

本节课我们完成了以下关键步骤：

• ✅ 正确配置 JDK、Maven 和 UTF-8 编码；
• ✅ 使用 IDEA 快速创建 Spring Boot 项目；
• ✅ 理解项目标准结构；
• ✅ 编写并测试第一个 REST 接口；
• ✅ 掌握修改服务端口的方法。

Spring Boot 的魅力在于“约定优于配置” —— 无需 XML、无需部署 WAR、无需手动配置 Tomcat，一切开箱即用。

📌 建议：后续开发强烈推荐使用 IntelliJ IDEA，其对 Spring Boot 的智能提示、热部署、调试支持极为友好。

从下一课开始，我们将深入 Spring Boot 的核心功能，如配置管理、Web 开发、数据访问等。