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://www.php.cn/link/5ecc613150de01b7e6824594426f24f4：
- 选 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），删掉它就得自己写 <dependencymanagement></dependencymanagement> 和 <build></build>，得不偿失。
立即学习“Java免费学习笔记（深入）”；
启动类必须在 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 没被扫到或端口被占。
