当前位置：首页 > news >正文

Spring Boot入门（快速搭建第一个项目，新手零配置）

news 2026/3/27 6:29:23

Spring Boot是Java后端开发的主流框架，简化了Spring的繁琐配置，实现“开箱即用”，但很多新手觉得Spring Boot配置复杂、门槛高，不敢上手。其实用Spring Initializr搭建Spring Boot项目，5分钟就能跑通第一个接口，零复杂配置！

今天分享Spring Boot的入门步骤——从搭建项目到编写第一个接口，每一步都有详细截图和代码，新手跟着操作，轻松跑通第一个Spring Boot项目～

一、准备工作：环境要求

JDK：8及以上（推荐1.8）；
IDE：IntelliJ IDEA（推荐，自带Spring Boot插件）；
构建工具：Maven/Gradle（本文用Maven）。

二、第一步：用Spring Initializr创建项目

1. 打开IDEA，点击「New Project」→ 选择「Spring Initializr」→ 点击「Next」。

2. 填写项目基本信息：

Name：项目名（如spring-boot-demo）；
Group：组织名（如com.example）；
Artifact：项目标识（如demo）；
Package name：包名（自动生成，无需改）；
Java Version：选择8；
点击「Next」。

3. 选择依赖（仅选Web即可）：

搜索「Spring Web」→ 勾选 → 点击「Next」。

4. 选择项目保存路径 → 点击「Finish」，IDEA会自动下载依赖（等待几分钟，首次下载较慢）。

三、第二步：项目结构解析（新手必懂）

创建完成后，项目核心结构如下：

spring-boot-demo/ ├── src/main/java/com/example/demo/ │ ├── DemoApplication.java // 项目启动类（核心！） │ └── controller/ // 控制器（写接口的地方，手动创建） ├── src/main/resources/ │ ├── application.properties // 配置文件（默认空，新手无需改） └── pom.xml // 依赖配置（自动生成）

DemoApplication.java：包含main方法，是项目的启动入口；
application.properties：全局配置文件（如端口、数据库配置）；
pom.xml：Maven依赖配置（Spring Web依赖已自动添加）。

四、第三步：编写第一个接口（核心！）

1. 手动创建controller包，在包下创建HelloController.java：

package com.example.demo.controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; // 标记为控制器，返回JSON数据（无需视图解析） @RestController public class HelloController { // 定义GET请求，路径为/hello @GetMapping("/hello") public String hello() { return "Hello Spring Boot! 新手也能轻松入门～"; } }

2. 代码说明：

@RestController：组合注解（@Controller + @ResponseBody），表示这是一个控制器，且返回值直接作为响应体（JSON/字符串）；
@GetMapping("/hello")：映射GET请求，访问路径为/hello；
方法返回字符串，会直接显示在浏览器中。

五、第四步：启动项目并测试接口

1. 启动项目：

找到DemoApplication.java，右键点击「Run DemoApplication」，控制台出现以下日志，说明启动成功：

Started DemoApplication in 2.531 seconds (JVM running for 3.124)

（默认端口8080，可在application.properties中修改：server.port=8081）

2. 测试接口：

打开浏览器，访问http://localhost:8080/hello，页面显示：

Hello Spring Boot! 新手也能轻松入门～

恭喜！第一个Spring Boot接口运行成功～

六、进阶：编写带参数的接口

修改HelloController，添加带参数的接口：

@GetMapping("/user") public String getUser(String name, Integer age) { return "姓名：" + name + "，年龄：" + age; }

访问http://localhost:8080/user?name=张三&age=20，页面显示：

姓名：张三，年龄：20

七、新手避坑指南

启动报错「Port 8080 was already in use」：端口被占用，修改application.properties中的server.port（如8081）；
依赖下载慢：在pom.xml中添加阿里云Maven镜像（百度搜“阿里云Maven镜像”，复制到pom.xml的中）；
接口访问404：检查包结构（controller必须在DemoApplication的同级/下级包下）；
注解写错：@RestController不要写成@Controller（否则返回视图名，不是字符串）。