llms.txt: machine-readable documentation index. Markdown version of this page is also available.

IntelliJ IDEA 2026.3 Help

教程:创建您的第一个 Spring 应用程序

本教程介绍如何在 IntelliJ IDEA 中创建和运行 Spring 应用程序。 这是一个由 Spring Boot Maven 项目,由 Spring Initializr生成。 这是创建 Spring 应用程序的最快方式,IntelliJ IDEA 提供了专门的项目向导。

在本教程中,您将学习如何创建一个返回问候语的 GET 端点,并在浏览器中测试此端点。 还将学习如何为 Spring 应用程序添加 static HTML 主页。

本教程使用 Java 25 语法。

创建一个新的 Spring Boot 项目

  1. 启动 IntelliJ IDEA。

    如果打开欢迎屏幕,请点击 新建项目。 否则,请在主菜单中转到 文件 | 新建 | 项目。

  2. 在 新建项目 向导中,从 生成器 列表中选择 Spring Boot。

  3. 为项目指定名称(例如, spring-boot-tutorial ),并在必要时更改默认位置路径。

  4. 选择 Java 作为 语言 ,并选择 Maven 作为 类型。

  5. 从 JDK 列表中,选择最新可用的 Oracle OpenJDK 版本。

    如果 JDK 已安装在您的计算机上,但未在 IDE 中定义,请选择 添加 JDK 并指定 JDK 主目录的路径。

    如果您的计算机上没有所需的 JDK,请选择 下载 JDK。

  6. 从 Java 列表中选择最新版本。

  7. 保留 其他字段 中的默认值。 点击 下一步 继续。

    新建项目向导中的 Spring Initializr
  8. 在下一个屏幕上,选择 Spring Web 依赖项,该依赖项位于 Web 节点下。 任何使用 Spring MVC 的 web 应用程序都需要此依赖项。

    新建项目向导中的 Spring 依赖项
  9. 点击 创建。 IntelliJ IDEA 将生成并设置项目。

添加一个发送问候的方法

Spring Initializr 创建一个包含 main() 方法的类,以引导您的 Spring 应用程序。 在本教程中,您将直接向此类添加新的 sayHello() 方法。

  1. 在 src/main/java/org/example/springboottutorial 软件包中,打开 SpringBootTutorialApplication.java 文件。

  2. 添加用于发送问候语的 sayHello() 方法。 为此,请在代码中添加所有必要的导入和注解,并将新的 sayHello () 方法添加到现有 SpringBootTutorialApplication 类中,使文件如下所示:

    package org.example.springboottutorial; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; @SpringBootApplication @RestController public class SpringBootTutorialApplication { static void main(String[] args) { SpringApplication.run(SpringBootTutorialApplication.class, args); } @GetMapping("/hello") public String sayHello(@RequestParam(value = "myName", defaultValue = "World") String name) { return String.format("Hello %s!", name); } }

    sayHello() 方法接受 名称 参数,并返回与参数值组合的词 Hello。 所有其他事务都通过添加 Spring 注释来处理:

    • @RestController 注解将 SpringBootTutorialApplication 类标记为请求处理程序(REST 控制器)。

    • @GetMapping("/hello") 注解将 sayHello() 方法映射到针对 /hello 的 GET 请求。

    • @RequestParam 注解将 名称 方法参数映射到 myName Web 请求参数。 如果未在 web 请求中提供 myName 形参,则默认使用 世界。

运行您的 Spring 应用程序

IntelliJ IDEA 会创建一个 Spring Boot 运行配置,您可以用它运行您的新 Spring 应用。

  1. 在主工具栏的 运行微件 中,选择 SpringBootTutorialApplication 并点击 运行 ,或按 Shift+F10。 还可以使用 运行 图标,该图标位于类声明或 main() 方法声明旁边的装订区域中。

    IntelliJ IDEA 将在 运行工具窗口 中显示正在运行的 Spring Boot 应用程序。 控制台 选项卡显示 Spring 日志消息的输出。

    包含正在运行的 Spring Boot 应用程序的 Run 工具窗口
  2. 打开 Web 浏览器。 默认情况下,内置 Apache Tomcat 服务器正在侦听 8080 端口,因此请转到 http://localhost:8080/hello。 如果一切正确,应该会看到应用程序以 Hello World! 响应。

    在浏览器中显示 Spring Boot Hello World 响应

    Hello World! 是默认的泛型响应。 您可以在网络请求中提供一个参数,以便应用程序正确地向您问候。 例如,尝试 http://localhost:8080/hello?myName=Human。

添加主页

创建的 Spring Boot 应用程序在 /hello 上有一个可用的端点。 但是,如果您在 http://localhost:8080/ 打开应用程序的根上下文,您将会遇到错误,因为没有定义根资源。 让我们添加一个包含指向您 endpoint 的链接的静态 HTML 主页。

  1. 在 项目 工具窗口中,右键点击 /src/main/resources/static/ 目录,选择 新建 | HTML 文件 ,指定名称 index.html ,然后按 Enter。

  2. 请修改默认模板或将其替换为以下 HTML 代码:

    <!DOCTYPE HTML> <html> <head> <title>Your first Spring application</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> </head> <body> <p><a href="/hello">Greet the world!</a></p> <form action="/hello" method="GET" id="nameForm"> <div> <label for="nameField">How should the app call you?</label> <input name="myName" id="nameField"> <button>Greet me!</button> </div> </form> </body> </html>
  3. 在 运行 工具窗口中,点击 重新运行按钮 或按 Shift+F10 重新启动您的 Spring 应用程序。

现在,您的应用将 index.html 作为根资源提供服务,位于 http://localhost:8080/。

应用程序显示在浏览器中的 localhost:8080 上

总结

通过本教程,您已经学会了如何:

后续步骤

您在本教程中创建的这个简单应用程序演示了如何开始使用 Spring。 要了解 IntelliJ IDEA 如何帮助您编写代码并在运行时管理应用程序,请参阅 下一个教程 ,其中重点介绍更高级的 Spring 支持功能。

要构建一个支持文件上传和下载、使用 H2 数据库并包含可执行文件 JAR 的 REST API,请按照 教程:构建 Spring Boot REST API 操作。

完整教程列表请参阅 IntelliJ IDEA 教程。

2026年 11月 3日