SpringBoot3.x入门到精通系列：1.2 开发环境搭建
SpringBoot 3.x 开发环境搭建
🎯 环境要求
在开始SpringBoot 3.x开发之前，我们需要准备以下开发环境：
必需组件
| 组件 | 版本要求 | 推荐版本 |
|---|---|---|
| JDK | 17+ | JDK 21 LTS |
| Maven | 3.6.3+ | 3.9.x |
| Gradle | 7.5+ | 8.x |
| IDE | 支持Java 17+ | IntelliJ IDEA 2023+ |
☕ JDK安装与配置
1. 下载JDK
推荐使用以下JDK发行版：
- Oracle JDK: 官方下载
- OpenJDK: AdoptOpenJDK
- Amazon Corretto: AWS Corretto
2. 安装JDK
Windows安装
# 下载msi安装包，双击安装
# 或使用Chocolatey
choco install openjdk17# 或使用Scoop
scoop install openjdk17
macOS安装
# 使用Homebrew
brew install openjdk@17# 设置JAVA_HOME
echo 'export JAVA_HOME=/opt/homebrew/opt/openjdk@17' >> ~/.zshrc
Linux安装
# Ubuntu/Debian
sudo apt update
sudo apt install openjdk-17-jdk# CentOS/RHEL
sudo yum install java-17-openjdk-devel
3. 验证安装
java -version
javac -version
期望输出：
openjdk version "17.0.8" 2023-07-18
OpenJDK Runtime Environment (build 17.0.8+7-Ubuntu-1ubuntu122.04)
OpenJDK 64-Bit Server VM (build 17.0.8+7-Ubuntu-1ubuntu122.04, mixed mode, sharing)
🔧 构建工具配置
Maven配置
1. 下载安装Maven
# Windows (Chocolatey)
choco install maven# macOS (Homebrew)
brew install maven# Linux
sudo apt install maven # Ubuntu/Debian
sudo yum install maven # CentOS/RHEL
2. 配置settings.xml
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd"><!-- 本地仓库路径 --><localRepository>D:/maven/repository</localRepository><!-- 镜像配置 --><mirrors><mirror><id>aliyun</id><name>Aliyun Maven</name><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf></mirror></mirrors><!-- 配置文件 --><profiles><profile><id>jdk-17</id><activation><activeByDefault>true</activeByDefault><jdk>17</jdk></activation><properties><maven.compiler.source>17</maven.compiler.source><maven.compiler.target>17</maven.compiler.target><maven.compiler.compilerVersion>17</maven.compiler.compilerVersion></properties></profile></profiles>
</settings>
Gradle配置
1. 安装Gradle
# Windows (Chocolatey)
choco install gradle# macOS (Homebrew)
brew install gradle# 或使用Gradle Wrapper (推荐)
./gradlew wrapper --gradle-version 8.4
2. 配置gradle.properties
# 全局配置文件位置: ~/.gradle/gradle.properties# JVM参数
org.gradle.jvmargs=-Xmx2048m -XX:MaxMetaspaceSize=512m# 并行构建
org.gradle.parallel=true# 构建缓存
org.gradle.caching=true# 配置仓库镜像
systemProp.maven.repo.central=https://maven.aliyun.com/repository/central
💻 IDE配置
IntelliJ IDEA配置
1. 下载安装
- IntelliJ IDEA官网
- 推荐使用Ultimate版本（学生可免费使用）
2. 配置JDK
File -> Project Structure -> Project Settings -> Project
- Project SDK: 选择JDK 17+
- Project language level: 17 - Sealed types, always-strict floating-point semantics
3. 配置Maven
File -> Settings -> Build, Execution, Deployment -> Build Tools -> Maven
- Maven home directory: 指向Maven安装目录
- User settings file: 指向settings.xml文件
- Local repository: 指向本地仓库目录
4. 安装有用的插件
File -> Settings -> Plugins
推荐插件：
- Spring Boot
- Lombok
- MyBatis Log Plugin
- Rainbow Brackets
- GitToolBox
VS Code配置
1. 安装扩展
{"recommendations": ["vscjava.vscode-java-pack","vmware.vscode-spring-boot","gabrielbb.vscode-lombok","redhat.java","vscjava.vscode-maven"]
}
2. 配置settings.json
{"java.home": "/path/to/jdk-17","java.configuration.runtimes": [{"name": "JavaSE-17","path": "/path/to/jdk-17"}],"maven.executable.path": "/path/to/maven/bin/mvn"
}
🚀 创建第一个项目
使用Spring Initializr
1. 在线创建
访问 Spring Initializr
配置项目：
Project: Maven Project
Language: Java
Spring Boot: 3.2.x
Group: com.example
Artifact: demo
Name: demo
Description: Demo project for Spring Boot
Package name: com.example.demo
Packaging: Jar
Java: 17
2. 命令行创建
curl https://start.spring.io/starter.zip \-d dependencies=web,data-jpa,h2 \-d type=maven-project \-d language=java \-d bootVersion=3.2.0 \-d baseDir=demo \-d groupId=com.example \-d artifactId=demo \-o demo.zipunzip demo.zip
cd demo
3. IDE集成创建
IntelliJ IDEA:
File -> New -> Project -> Spring Initializr
VS Code:
Ctrl+Shift+P -> Spring Initializr: Generate a Maven Project
验证环境
创建简单的Controller测试：
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;@SpringBootApplication
public class DemoApplication {public static void main(String[] args) {SpringApplication.run(DemoApplication.class, args);}
}@RestController
class HelloController {@GetMapping("/hello")public String hello() {return "Hello SpringBoot 3.x!";}
}
运行应用：
./mvnw spring-boot:run
访问测试：
curl http://localhost:8080/hello
🔍 常见问题解决
1. JDK版本问题
# 检查当前Java版本
java -version# 设置JAVA_HOME环境变量
export JAVA_HOME=/path/to/jdk-17
2. Maven依赖下载慢
<!-- 使用阿里云镜像 -->
<mirror><id>aliyun</id><url>https://maven.aliyun.com/repository/public</url><mirrorOf>central</mirrorOf>
</mirror>
3. IDE无法识别SpringBoot项目
- 确保安装了SpringBoot插件
- 重新导入Maven/Gradle项目
- 清理并重新构建项目
📋 环境检查清单
- JDK 17+安装并配置
- Maven/Gradle安装并配置
- IDE安装并配置插件
- 网络连接正常（下载依赖）
- 创建测试项目成功
- 应用启动正常
- 接口访问正常
🔗 下一篇
环境搭建完成后，下一篇我们将创建第一个完整的SpringBoot 3.x应用，并深入了解项目结构。
本文关键词: 开发环境, JDK17, Maven, Gradle, IntelliJ IDEA, Spring Initializr