开发环境搭建JDK/Maven/IDEA全套配置工欲善其事必先利其器。写SpringBoot之前先把厨房收拾利索不然代码还没写环境先给你整破防了。一、JDK安装与配置1.1 为什么选JDK17JDK17是当前的LTS长期支持版本SpringBoot 3.x最低要求就是JDK17。别再去装JDK8了那已经是上一代人的浪漫了。JDK17在性能、语法record、密封类、模式匹配上都有明显提升且官方长期支持到2029年。下载地址推荐Oracle官方或OpenJDK发行版如Temurin、Zulu个人建议用TemurinAdoptium维护完全开源免费。1.2 安装与环境变量配置Windows下安装后核心是配置两个环境变量JAVA_HOME C:\Program Files\Java\jdk-17 PATH %JAVA_HOME%\bin;%PATH%配置完成后打开终端验证java-version# 输出类似openjdk version 17.0.10 2024-01-16javac-version# 输出类似javac 17.0.10两条命令都有正常输出JDK就算搞定了。如果提示不是内部或外部命令八成是PATH没配对去检查路径有没有写错。二、Maven安装配置2.1 下载解压Maven是Java项目的依赖管理和构建工具SpringBoot项目离不开它。去官网下载Binary zip包apache-maven-x.x.x-bin.zip解压到任意目录比如D:\dev\apache-maven-3.9.62.2 环境变量配置MAVEN_HOME D:\dev\apache-maven-3.9.6 PATH %MAVEN_HOME%\bin;%PATH%验证mvn-version# 输出包含 Maven 版本号和 Java 版本信息2.3 settings.xml关键配置打开D:\dev\apache-maven-3.9.6\conf\settings.xml做两件大事第一件配阿里云镜像不然下个依赖能等到天荒地老mirrorsmirroridaliyunmaven/idmirrorOf*/mirrorOfname阿里云公共仓库/nameurlhttps://maven.aliyun.com/repository/public/url/mirror/mirrors第二件改本地仓库路径默认在C盘别把系统盘塞爆localRepositoryD:\dev\maven-repo/localRepository配完之后第一次构建项目时Maven会自动把依赖下载到这个目录后续就走的本地缓存了。三、IDEA安装与基础配置3.1 社区版 vs 旗舰版对比项社区版免费旗舰版收费Java开发基础支持支持数据库工具需装插件内置HTTP客户端需装插件内置Spring Boot支持插件支持深度集成框架智能提示基础全面新手学习阶段社区版完全够用。如果是学生用教育邮箱可以免费申请旗舰版。3.2 必装插件推荐Lombok用注解干掉getter/setter/构造器代码量直接砍半MyBatisXMyBatis-Plus增强插件 mapper接口和XML跳转神器EnvFile管理多环境配置文件很方便3.3 IDEA核心配置编码设置防止中文乱码这步不做后面全是坑File → Settings → Editor → File Encodings Global Encoding: UTF-8 Project Encoding: UTF-8 Default encoding for properties files: UTF-8Maven配置让IDEA用我们自己装的MavenFile → Settings → Build → Build Tools → Maven Maven home path: D:\dev\apache-maven-3.9.6 User settings file: D:\dev\apache-maven-3.9.6\conf\settings.xml Local repository: D:\dev\maven-repo四、IDEA创建SpringBoot项目初体验4.1 使用Spring InitializrIDEA新建项目时选择Spring Initializr社区版需装Spring Boot插件关键配置Project SDK选择JDK17TypeMavenLanguageJavaPackagingJarJava Version17Spring Boot版本选3.x稳定版4.2 选择起步依赖学习Web开发勾选这两个就够起步Spring Web内嵌Tomcat Spring MVCLombok减少样板代码4.3 项目结构说明my-project/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/example/myproject/ │ │ │ └── MyProjectApplication.java # 启动类 │ │ └── resources/ │ │ └── application.properties # 配置文件 │ └── test/ │ └── java/ └── pom.xml # Maven依赖配置MyProjectApplication.java项目入口main方法所在类application.properties全局配置文件后续建议换成yml格式pom.xml依赖管理核心文件五、常见环境问题排查5.1 JDK版本冲突症状编译报invalid target release: 17或运行时版本不对。排查三个地方版本必须统一1. Project Structure → Project SDK 17 2. Project Structure → Modules → Language level 17 3. Settings → Build → Compiler → Java Compiler → Target bytecode version 175.2 Maven下载慢/下不动症状依赖一直 downloading半天不结束。排查确认settings.xml里阿里云镜像配了且路径对IDEA的Maven设置指向了正确的settings.xml实在不行删掉本地仓库里对应的.lastUpdated文件再重试批量清理lastUpdated文件Windows命令行# 进到本地仓库目录执行del /s *.lastUpdated5.3 IDEA内存配置项目大了之后IDEA容易卡编辑IDEA安装目录下的bin/idea64.exe.vmoptions-Xms512m -Xmx2048m -XX:ReservedCodeCacheSize512m-Xmx是最大堆内存建议根据机器内存给到2G-4G别心疼内存就是拿来用的。