vscode中spring boot项目建立与环境配置

102300210曹英男 2025-12-25 22:24:47

这个作业属于哪个课程	https://bbs.csdn.net/forums/FZU_university_2025
这个作业要求在哪里	https://bbs.csdn.net/topics/620074912
这个作业的目标	介绍vscode中spring boot项目建立与环境配置
其他参考文献	无
目录一、前言二、项目建立的详细流程 VSCode 开发环境配置:插件安装创建流程第一步：项目版本与依赖设置第二步：检查项目的配置文件与结构层第三步：测试是否创建完毕三、总结

一、前言

本技术博客意在为java项目的新手开发者提供一个便捷的开发框架spring boot，这个框架提供了默认配置和内嵌 Web 服务器，让开发者能专注于编写业务逻辑，而无需进行繁琐的初始设置。只需简单的几步，即可创建一个独立运行、功能完备的 Web 应用或微服务。以下的流程与问题描述都是以vscode平台开发为基础。如有不正确的描述，欢迎积极指正。

二、项目建立的详细流程

VSCode 开发环境配置:插件安装

1.Java Extension Pack - Java 开发基础套件

2.Spring Boot Extension Pack - Spring Boot 专用工具集

3.Maven for Java - Maven 项目管理

4.Lombok Annotations Support - Lombok 注解支持

创建流程

第一步：项目版本与依赖设置

在vscode中，按下ctrl+shift+p键，输入spring boot,
在可选项中选择：Spring Initializr: Create a new maven project，选择项目的版本以及java语言、版本，packaging type选择jar。

接下来会要求你选择项目的依赖部件，根据个人的开发需求来自行选择即可，例如对于创建数据库依赖的微信小程序，需要"spring web"处理http请求，"spring data jpa"处理数据库操作，"spring boot devtools"开发工具，"lombok"对象映射工具,"mysql driver"连接数据库等等，这些选择的依赖也可以在后续自动生成的根文件夹下pom.xml文件中查看与修改，但是会相对麻烦，所以还是推荐在这一阶段设置完全。

如果java版本设置有误，或者选定的部分依赖缺少，那么平台内部右下角会提示错误，用户可以自行按照弹出的指示一键修改。

第二步：检查项目的配置文件与结构层

正常情况下，按照上面步骤生成的spring boot项目还并不具有完整的java项目框架，需要自行添加一些文件，以下讲进行说明：

首先，主要的程序开发路径在/src/main/java/com/example/demo目录下,为了完整的结构，需要创建controller、service、repository、entity目录，分别用于存放控制器、服务、数据访问层、实体类,同时需要根据项目的需求创建其他目录，对于上述开发的小程序而言，应该有以下几个目录：service、repository、entity、controller、mapper、utils。

其次，对于项目的配置文件，在/src/main/resources目录下，有一个application.properties文件，用于配置项目的属性，例如数据库连接信息、端口号等等，可以根据用户后续开发的需求设置。

第三步：测试是否创建完毕

创建完成后，最简单的验证方式是直接查看项目的文件分层结构是否如上述所言。

如果需要更加具体可靠的测试方式，可以尝试运行项目，首先，假设你的项目结构如下：
demo/
├── src/main/java/com/example/demo/
│ ├── DemoApplication.java
│ └── controller/
│ └── HelloController.java
├── src/main/resources/
│ └── application.properties
└── pom.xml
编辑DemoApplication.java内的代码如下：

package com.example.demo;  // 你的包名，根据创建时填写的内容调整

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

/**
 * Spring Boot 主启动类
 * 用于验证项目创建是否成功
 */
@SpringBootApplication
@RestController  // 添加这个注解，使类可以处理HTTP请求
public class DemoApplication {
    
    public static void main(String[] args) {
        // 启动Spring Boot应用
        SpringApplication.run(DemoApplication.class, args);
        System.out.println("✅ Spring Boot 应用启动成功！");
    }
    
    /**
     * 最简单的测试接口
     * 访问地址：http://localhost:8080/hello
     */
    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot! 项目创建成功！";
    }
    
    /**
     * 健康检查接口
     * 访问地址：http://localhost:8080/health
     */
    @GetMapping("/health")
    public String health() {
        return "{\"status\": \"UP\", \"timestamp\": \"" + java.time.LocalDateTime.now() + "\"}";
    }
}

创建文件src/main/resources/application.yml，其中代码如下：

# 服务器配置
server:
  port: 8080                    # 服务端口

# 应用配置
spring:
  application:
    name: demo-app              # 应用名称

# 日志配置（可选，让输出更简洁）
logging:
  level:
    root: INFO                 # 只显示INFO及以上级别的日志

配置代码完毕后在DemoApplication.java中选择编译运行。

打开浏览器

访问：http://localhost:8080/hello

预期显示：Hello, Spring Boot! 项目创建成功！

访问：http://localhost:8080/health

预期显示：{"status": "UP", "timestamp": "2024-01-15T10:30:01.123456"}

此时说明项目测试成功。

三、总结

本篇博客详细记录了在VSCode中使用Spring Initializr创建Spring Boot项目的完整实践。内容涵盖从环境准备、插件安装、依赖选择（如Spring Web, JPA, Lombok）到项目结构与基础配置的每一步操作。通过这次实践，不仅掌握了高效构建项目的标准化流程，更深刻体会到“约定大于配置”的思想如何提升开发效率，为后续复杂功能开发奠定了坚实基础。

...全文