Spring框架配置与项目初始化教程

一分耕耘，一分收获！既然都打开这篇《Spring框架Java环境配置与项目初始化教程》，就坚持看下去，学下去吧！本文主要会给大家讲到等等知识点，如果大家对本文有好的建议或者看到有不足之处，非常欢迎大家积极提出！在后续文章我会继续更新文章相关的内容，希望对大家都有所帮助！

Spring项目初始化应使用Spring Initializr并正确配置spring-boot-starter-parent和spring-boot-starter-web，确保parent声明、依赖引入、启动类位置（根包）及配置文件路径/编码无误。

Spring 项目初始化不是“配环境”，而是选对起点——用 spring-boot-starter-parent 和 spring-boot-starter-web 就能跳过 XML 配置、Servlet 容器部署、依赖版本冲突等老问题。

用 Spring Initializr 快速生成基础项目

手动建 Maven 工程再加一堆 dependency 容易漏掉 spring-boot-maven-plugin 或写错 parent，直接访问 https://start.spring.io：

• 选 Java 版本（建议 17+，Spring Boot 3.x 要求 JDK 17）
• 填 Group（如 com.example）、Artifact（如 demo）
• 勾选 Spring Web（替代旧版的 spring-webmvc）
• 生成 ZIP 解压后导入 IDE，mvn clean compile 能过就说明依赖和插件已就位

确认 pom.xml 的 parent 和关键 starter 是否正确

很多人复制旧项目配置，把 spring-boot-starter-parent 写成普通 parent 或漏掉 version，导致 @RestController 找不到或 SpringApplication.run() 启动失败。

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>3.2.5</version>
  <relativePath/>
</parent>

<dependencies>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
</dependencies>

注意：spring-boot-starter-parent 不是可选的——它统一管理依赖版本、默认插件配置（比如 spring-boot-maven-plugin），删掉它就得自己写 和 ，得不偿失。

启动类必须在 package 根路径下，否则组件扫描失效

@SpringBootApplication 默认只扫描该类所在包及其子包。如果启动类放在 com.example.config，而 @RestController 在 com.example.controller（同级），就不会被加载。

• 启动类命名建议为 Application.java，放在 com.example（即 Group ID 对应的最外层包）
• 不要把它塞进 config、util 这类子包里
• 若必须放别处，用 @SpringBootApplication(scanBasePackages = "com.example")

application.properties / application.yml 位置和常见坑

配置文件必须放在 src/main/resources/ 下，名字必须是 application.properties 或 application.yml（不能叫 app.properties 或大小写错误）。

常见低级错误：

• server.port=8080 写成 server.port = 8080（YAML 要求冒号后必须空格）
• spring.profiles.active=dev 写在 application-dev.properties 里（它不会自动激活自己，得写在主配置里）
• 中文注释用了 # 但文件编码不是 UTF-8（IDEA 默认是 UTF-8，Eclipse 可能是 GBK，导致乱码后配置失效）

启动时看控制台第一行：如果看到 Started Application in X seconds，说明配置加载成功；如果卡在 Tomcat started on port(s): 8080 之后没日志，大概率是 @RestController 没被扫到或端口被占。

终于介绍完啦！小伙伴们，这篇关于《Spring框架配置与项目初始化教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！