创建项目：使用Spring Initializr初始化你的第一个应用程序

摘要：在上一章中，我们成功地搭建了JDK 17和Maven的开发环境，为我们的编码之旅奠定了坚实的基础。理论与环境准备就绪，是时候亲手缔造我们的第一个Spring Boot项目了。本章将聚焦于官方推荐的项目创建方式——使用Spring Initializr，它是一个强大的项目生成工具，能帮助我们快速、规范地构建应用骨架，避免繁琐的手动配置。

---

引言：告别刀耕火种

“工欲善其事，必先利其器”。在上一章，我们已经将JDK和Maven这两大利器准备就绪。现在，我们面临一个问题：如何开始一个全新的Spring Boot项目？是手动创建文件夹、编写pom.xml文件吗？不，那样的“刀耕火种”时代早已过去。Spring官方为我们提供了一个现代化的“项目启动器”——Spring Initializr。

本章的核心目标就是：学会使用Spring Initializr，并理解它为我们生成的项目结构。这是从0到1的关键一步，也是后续所有实战的起点。

一、核心概念：Spring Initializr是什么？

Spring Initializr是一个Web应用程序，它会为你生成一个基础的Spring Boot项目结构。你可以把它想象成一个项目的“脚手架”工具，你只需要选择你需要的技术（如Web开发、数据库连接等），它就会自动为你配置好所有基础依赖和文件。

它的主要优势体现在以下几点：

• 规范性：确保生成的项目结构是标准的、最佳实践的。
• 易用性：通过简单的Web界面勾选即可完成配置，无需记忆繁杂的依赖项名称。
• 版本协调：自动管理Spring Boot版本与各个起步依赖之间的兼容性，避免版本冲突。
• 效率提升：一键生成项目，让你专注于业务代码而非项目配置。

我们可以用一个简单的流程图来展示它的工作模式：

二、实战操作：通过Web界面创建项目

让我们立刻动手实践。请打开浏览器，访问官方的Spring Initializr网站：

• 官方地址: https://start.spring.io/

你会看到一个清晰的配置界面。下面我们来逐项解析并完成配置。

1. Project: 选择 Maven。这对应我们上一章安装的构建工具。
2. Language: 选择 Java。
3. Spring Boot: 选择一个最新的非SNAPSHOT稳定版本，例如 3.3.1。
4. Project Metadata (项目元数据):
   • Group: 通常是你的公司或组织的域名倒写，例如 com.example。它是项目的坐标，用于区分不同组织的项目。
   • Artifact: 你的项目名称，例如 my-first-app。
   • Name: 同 Artifact。
   • Description: 项目的简短描述，例如 Demo project for Spring Boot。
   • Package name: 会根据Group和Artifact自动生成，如 com.example.myfirstapp。这是你Java代码的主包名。
5. Packaging: 选择 Jar。这意味着我们的应用将被打包成一个可独立运行的Jar文件，因为它内置了Web服务器。
6. Java: 选择 17。这对应我们上一章安装的JDK版本。
7. Dependencies (依赖):
   • 点击右侧的 “ADD DEPENDENCIES…” 按钮。
   • 在搜索框中输入 “Web”，然后选择 Spring Web。这个依赖包含了构建Web应用和RESTful API所需的一切。

完成以上所有配置后，点击页面底部的 “GENERATE” 按钮。浏览器会自动下载一个名为 my-first-app.zip 的压缩文件。

三、剖析项目结构

将下载的压缩包解压后，你会得到一个结构清晰的Maven项目。让我们用一个思维导图来看看它的核心构成：

下面我们来解读其中最重要的几个文件和目录：

• pom.xml: Maven的核心配置文件。它定义了项目的依赖、父项目（spring-boot-starter-parent，负责版本管理）、插件等。我们添加的spring-boot-starter-web依赖就在这里。
• src/main/java/com/example/myfirstapp/MyFirstAppApplication.java: 这是Spring Boot应用的主入口类。它包含一个main方法，是整个应用的启动点。
• src/main/resources: 资源目录。
  • application.properties: 应用的主配置文件。你可以在这里定义数据库连接、服务器端口等各种配置。
  • static: 用于存放静态资源，如CSS、JavaScript、图片等。
  • templates: 用于存放模板文件，如Thymeleaf或FreeMarker的页面模板。
• src/test/java/.../MyFirstAppApplicationTests.java: 一个基础的单元测试类。Spring Initializr自动为我们生成了一个测试框架，鼓励我们编写测试。
• .gitignore: Git版本控制的忽略文件，默认配置了需要忽略的常见文件和目录。
• mvnw 和 mvnw.cmd: Maven Wrapper（Maven包装器）。它允许没有安装Maven的开发者也能构建项目，实现了项目构建环境的统一。

总结

恭喜你！通过本章的学习，你已经成功地跨出了Spring Boot开发的第一步。我们不仅理解了Spring Initializr作为现代化项目构建工具的核心价值，还亲手创建了一个结构标准、配置完善的Spring Boot项目。

我们完成了两件关键的事情：

• 学习了Spring Initializr：掌握了通过其Web界面生成项目的方法。
• 剖析了项目结构：理解了生成的项目中各个核心文件和目录的作用。

现在，我们拥有了一个坚实的、可运行的项目骨架。这个由Spring Initializr生成的项目，将是我们未来学习所有Spring Boot功能的“试验田”。

预告：项目已经创建，但它还静静地躺在我们的文件夹里。如何让它“活”起来？下一章，我们将学习如何将这个项目导入到主流的集成开发环境（IDE）中，并真正地运行、调试它。我们将进入 集成开发环境：在IntelliJ IDEA中高效运行与调试Spring Boot 的学习。敬请期待！