新手搭建Spring Boot环境核心是JDK 17、IDE(推荐IntelliJ IDEA社区版)、构建工具(Maven或Gradle);需配置JAVA_HOME和Path验证java -version,IDEA内置Maven建议改本地仓库路径并配阿里云镜像。

新手装 Spring Boot 环境,核心就三样:JDK、IDE(开发工具)、构建工具(Maven 或 Gradle),其他都是围绕这三样展开的配置和优化。
JDK 17 是当前最稳妥的选择
Spring Boot 3.x 要求 JDK 17 及以上,而 JDK 17 是长期支持(LTS)版本,稳定、官方维护久、社区资料多。别用 JDK 8(已过时,不兼容 Spring Boot 3)、也别盲目追最新版(如 JDK 21,部分插件或教程可能还没完全适配)。
- 去 Oracle 官网或 Eclipse Temurin 下载 JDK 17(推荐 Temurin,免注册、开源、国内访问快)
- 安装后必须配置 JAVA_HOME 系统变量,指向 JDK 安装目录(比如
D:\Program Files\Java\jdk-17.0.2) - 把
%JAVA_HOME%\bin加进系统 Path,然后在命令行输入java -version和javac -version验证——两个命令都输出 17.x 才算成功
IntelliJ IDEA 社区版足够用
不用买专业版,也不用硬上 VS Code(对 Spring Boot 新手来说,配置 Java 插件链略麻烦)。IDEA 社区版免费,自带 Maven、Gradle 支持,Spring Initializr 集成完善,新建项目一步到位。
- 下载 2023.3 或更新版本(太老的版本,比如 2021.1 以前,可能不支持 Spring Boot 3 的自动配置提示)
- 安装时勾选「Add to PATH」(方便后续命令行调用)
- 首次启动后,在 Settings → Build → Gradle / Maven 中确认它默认使用的 JDK 和构建工具版本,跟本地一致即可
Maven 不用单独装,但得会配
IDEA 内置了 Maven,开箱即用。但默认用的是 C 盘用户目录下的 .m2/repository,容易占满系统盘,也影响重装系统后的依赖复用。
- 建议手动改 Maven 本地仓库路径:Settings → Build → Maven → Local repository,改成 D 盘某个固定路径(比如
D:\maven-repo) - 顺手配个阿里云镜像(加快依赖下载):编辑 IDEA 内置的
settings.xml(或自己放一份到D:\maven\conf\settings.xml),在<mirrors>标签下加一段镜像配置 - 不需要运行
mvn -v验证——只要 IDEA 能正常创建 Maven 项目、能下载依赖、没报红,就说明 Maven 已就位
其他可选但非必需项
刚起步时,这些先放一边:
- 数据库(MySQL/PostgreSQL):等写到数据层再装,现在连 H2 内存数据库都不急着配
- Postman 或 curl:测试接口用,IDEA 自带 HTTP Client 就够临时用
- Lombok、MyBatis Plus 等插件:第一项目先不用,避免干扰对 Spring Boot 基础机制的理解


















