从零搭建SpringBoot Web单体项目1、IDEA搭建SpringBoot项目

程序员岳彬

已于 2025-05-23 11:07:34 修改

阅读量1.2k

点赞数 2

于 2022-05-09 21:09:09 首次发布

本文链接：https://blog.csdn.net/qq_35766758/article/details/124662860

版权

SpringBoot项目实战全流程专栏收录该内容

3 篇文章

订阅专栏

本文详细介绍了如何使用IDEA搭建并运行一个基于SpringBoot的Web应用，包括项目创建、依赖配置、控制器编写、模板引擎应用及部署测试。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

系列文章

从零搭建SpringBoot Web单体项目【基础篇】1、IDEA搭建SpringBoot项目

从零搭建 SpringBoot Web 单体项目【基础篇】2、SpringBoot 整合数据库

一、环境准备

1. 开发环境配置

开发工具：IDEA（IntelliJ IDEA）
JDK 版本：1.8
构建工具：Maven 3.6

2. 技术栈选择

框架：Spring Boot 2.6.7（快速构建企业级应用）
依赖管理：Maven（自动化构建与依赖管理）
模板引擎：Apache Freemarker（前后端混合开发场景）
代码简化：Lombok（消除冗余 Java 代码）

二、新建一个SpringBoot项目

1. 初始化项目

1.1. 启动idea,选择新增:File->New->Project,进入项目创建向导

1.2. 选择Spring Initializr，点击next；（jdk1.8默认即可）

3. 填写项目相关信息

Group: com.pearl (组织标识符)
Artifact: pearl-boot (项目唯一标识)
Package: com.pearl (基础包名，后续代码将在此路径下组织)

修改完成，点击next。

2.配置maven 依赖

在 Dependencies 界面勾选以下组件：

Developer Tools下勾选Lombok（简化 POJO 类开发）;
Web下勾选Spring Web（包含 Spring MVC 核心功能）；
Template Englines勾选Apache Freemarker（模板渲染引擎）；

点击 next 进入下一步

3. 完成项目创建

3.1. 选择代码存储路径（建议使用默认路径），点击 Finish。

3.2. IDEA 将自动生成项目骨架并加载 Maven 依赖，等待片刻后即可看到完整的项目结构。

三、项目基础配置与工具集成

1. 配置Maven仓库

1.1. 打开 Maven 面板：点击 IDEA 右侧的 Maven 图标，点击设置按钮（扳手图标）。

1.2.指定本地 Maven

选择本地Maven路径；勾选配置文件后边的选项，然后修改为本地Maven的配置文件，它会根据配置文件直接找到本地仓库位置.

Maven home directory：选择本地 Maven 安装路径（如E:/Program Files/maven/apache-maven-3.6）。
User settings file：指向 Maven 的settings.xml配置文件（通常位于conf目录下）。
自动填充 Local repository 路径（根据配置文件自动识别）

1.3. 刷新依赖

配置完后，如果没有自动导包，可以点击Maven 面板左上角重新导包按钮（圆形箭头图标），或者点击下载按钮，选择下载所有源文件和文档

2. 安装 Lombok 插件

2.1. 进入插件市场：点击 File -> Settings -> Plugins -> Marketplace。

2.2. 搜索 Lombok：输入 “Lombok”，找到官方插件并点击 Install。

注：解决idea在plugins中搜不到插件见解决idea在plugins中搜索不到插件

2.3. 重启 IDEA：安装完成后，点击提示的 Restart IDE 使插件生效。

四、开发第一个 Web 页面

1. 创建DemoController（控制器）

在com.pearl.modules.demo下新建controller文件夹，在controller文件夹下建一个简单的DemoController类。代码如下：

package com.pearl.modules.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

/**
 * Demo类
 *
 * @author yaobin-yue
 * @date 2022/5/9
 */
@Controller
public class DemoController {

    /***
     * 测试
     * @param model
     * @return
     */
    @RequestMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("content", "欢迎进入Demo页面");
        return "demo";
    }
}

2. 创建demo.ftl页面（视图）

在resources/templates文件下新建demo.ftl页面，代码如下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
</head>
<body>
    <h2>Demo页面</h2>
    <h2>${content}</h2>
</body>
</html>

3. 配置yml

把application.properties改为 application.yml，内容修改如下：

## ===Spring配置===
spring:
  #=====项目启动端口=====
  port: 8080

  # ===freemarker配置===
  freemarker:
    template-loader-path: classpath:/templates
    cache: false
    charset: UTF-8
    check-template-location: true
    content-type: text/html
    expose-request-attributes: false
    expose-session-attributes: false
    request-context-attribute: request
    suffix: .ftl

五、项目启动与测试

1. 运行项目启动类Application.java

package com.pearl;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * 启动类
 * @author  yaobin-yue
 * @date  2022/5/9
 */
@SpringBootApplication
public class PearlBootApplication {

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

}

2. 访问测试页面

打开浏览器，访问：127.0.0.1:8080/demo/hello，结果如下：

六、常见问题与解决方案

1. Lombok 注解失效

检查 IDEA 是否安装 Lombok 插件并重启 IDE。
确认pom.xml中已包含 Lombok 依赖：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

2. Freemarker 页面 404 错误

检查模板文件路径是否与application.yml中配置的suffix和template-loader-path一致。
确认控制器方法返回的视图名称正确（如return "demo"对应demo.ftl）。