1. 环境准备：JDK安装与配置全流程

作为Java开发的基石，JDK的正确安装是Spring Boot项目运行的前提条件。我推荐使用JDK 8或JDK 11这两个长期支持版本，它们在企业级开发中具有最好的兼容性。

1.1 JDK下载与安装

首先访问Oracle官网下载对应操作系统的JDK安装包。这里有个小技巧：如果你需要历史版本，可以到Oracle的Java存档页面查找。安装时建议选择自定义路径，避免使用包含空格或中文的目录，比如我习惯安装在D:\Java\jdk1.8.0_301这样的路径下。

安装过程中会提示安装JRE，其实可以跳过，因为JDK已经包含了JRE。但如果你担心某些特殊场景需要独立JRE，可以安装在同级目录下，比如D:\Java\jre1.8.0_301。

1.2 环境变量配置详解

环境变量配置是新手最容易出错的地方。需要配置三个关键变量：

1. JAVA_HOME：指向JDK安装根目录
2. Path：添加%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin
3. CLASSPATH（可选）：设置.%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar

重要提示：Windows 10/11的Path变量现在支持每行单独编辑，比旧版的用分号分隔更清晰。配置完成后，一定要新开一个CMD窗口测试，因为环境变量修改不会自动应用到已打开的终端。

验证安装是否成功：

java -version javac -version

这两个命令应该显示相同的版本号。如果出现"不是内部或外部命令"的错误，99%是Path配置有问题。

2. Maven安装与深度配置

2.1 Maven核心安装步骤

从Apache官网下载最新版Maven二进制包（建议3.6.3+版本），解压到不含中文和空格的目录，比如D:\apache-maven-3.8.6。然后配置环境变量：

1. MAVEN_HOME：指向Maven解压目录
2. Path：添加%MAVEN_HOME%\bin

验证安装：

mvn -v

2.2 仓库配置与加速技巧

Maven默认仓库在国外，下载速度慢。建议修改conf/settings.xml：

1. 更换阿里云镜像：

<mirror> <id>aliyunmaven</id> <mirrorOf>*</mirrorOf> <name>阿里云公共仓库</name> <url>https://maven.aliyun.com/repository/public</url> </mirror>

2. 修改本地仓库位置（避免占用C盘空间）：

<localRepository>D:\maven-repository</localRepository>

3. 提升下载速度的额外配置：

<profile> <id>default</id> <repositories> <repository> <id>aliyun</id> <url>https://maven.aliyun.com/repository/public</url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories> </profile>

3. IntelliJ IDEA安装与优化配置

3.1 安装注意事项

从JetBrains官网下载Ultimate版（30天试用）或Community版（免费）。安装时注意：

1. 不要安装在Program Files目录下，可能遇到权限问题
2. 勾选"Add launchers dir to the PATH"方便命令行启动
3. 关联.java文件（可选）

3.2 首次启动关键设置

1. 主题选择：Darcula暗色主题更护眼
2. 插件安装：必装插件列表：
   • Lombok（简化POJO）
   • Spring Assistant（Spring Boot支持）
   • Maven Helper（依赖分析）
3. VM参数调优：修改idea64.exe.vmoptions：

   -Xms1024m -Xmx2048m -XX:ReservedCodeCacheSize=512m

3.3 配置JDK和Maven

1. 配置JDK：File → Project Structure → SDKs → 添加JDK
2. 配置Maven：File → Settings → Build → Maven
   • Maven home path：指向你的Maven安装目录
   • User settings file：选择修改过的settings.xml
   • Local repository：确认是否正确指向自定义仓库

避坑提示：IDEA内置的Maven版本可能不是最新的，建议使用自己安装的Maven。同时关闭"Use plugin registry"选项可以避免一些奇怪的插件冲突。

4. 创建第一个Spring Boot项目

4.1 通过Spring Initializr创建

在IDEA中选择File → New → Project → Spring Initializr，关键配置：

1. Project Metadata：

   • Group：com.yourdomain
   • Artifact：demo
   • Packaging：Jar（推荐）
   • Java Version：与你安装的JDK一致

2. Dependencies：

   • Spring Web（必选）
   • Lombok（推荐）
   • Spring Boot Actuator（监控，可选）

4.2 项目结构解析

创建后的标准结构：

demo ├── src │ ├── main │ │ ├── java │ │ │ └── com │ │ │ └── yourdomain │ │ │ └── DemoApplication.java │ │ └── resources │ │ ├── application.properties │ │ ├── static │ │ └── templates │ └── test └── pom.xml

4.3 关键文件配置

1. pom.xml检查点：

   • 确认parent是spring-boot-starter-parent
   • 检查Java版本与JDK一致
   • 依赖项版本是否冲突（可用mvn dependency:tree查看）

2. application.properties基础配置：

   server.port=8080 spring.application.name=demo logging.level.root=INFO

5. 运行与调试技巧

5.1 启动应用

直接运行DemoApplication类的main方法。看到如下日志表示成功：

Started DemoApplication in 2.305 seconds (JVM running for 2.876)

5.2 常见问题解决

1. 端口冲突：修改server.port或终止占用端口的进程

   netstat -ano | findstr 8080 taskkill /PID [pid] /F

2. 依赖下载失败：

   • 删除本地仓库中.lastUpdated文件
   • 执行mvn clean install -U

3. Bean冲突：

   • 使用@Primary注解
   • 排除特定自动配置：@SpringBootApplication(exclude={...})

5.3 开发效率技巧

1. 热部署：添加devtools依赖

   <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-devtools</artifactId> <scope>runtime</scope> <optional>true</optional> </dependency>

   然后开启IDEA的自动编译：Settings → Build → Compiler → Build project automatically

2. Lombok使用：简化实体类

   @Data @Builder @NoArgsConstructor @AllArgsConstructor public class User { private Long id; private String name; }

6. 进阶配置与优化

6.1 多环境配置

1. 创建不同配置文件：

   • application-dev.properties（开发环境）
   • application-test.properties（测试环境）
   • application-prod.properties（生产环境）

2. 激活配置：

   java -jar demo.jar --spring.profiles.active=prod

6.2 日志配置

在application.properties中：

logging.file.name=logs/app.log logging.level.com.yourpackage=DEBUG logging.pattern.console=%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n

6.3 健康检查与监控

启用Actuator后访问：

• /actuator/health（健康状态）
• /actuator/info（应用信息）
• /actuator/metrics（性能指标）

安全配置：

management.endpoints.web.exposure.include=health,info management.endpoint.health.show-details=when_authorized

7. 项目打包与部署

7.1 打包可执行JAR

mvn clean package

生成的jar包在target目录下，包含嵌入式Tomcat，可直接运行：

java -jar demo-0.0.1-SNAPSHOT.jar

7.2 生产环境建议

1. JVM参数优化：

   java -Xms512m -Xmx1024m -jar demo.jar

2. 使用启动脚本：

   #!/bin/bash nohup java -jar demo.jar > console.log 2>&1 &

3. 监控建议：

   • 使用Spring Boot Admin
   • 集成Prometheus + Grafana

8. 常见问题速查表

9. 个人实战经验分享

在实际企业级开发中，我总结了几个关键点：

1. 版本一致性：团队所有成员应该使用相同的JDK、Maven和IDEA版本，避免"在我机器上能运行"的问题。可以通过.mvn/jvm.config和.idea目录下的配置实现版本控制。

2. 依赖管理：Spring Boot的starter-parent已经定义了大多数依赖的兼容版本，不要轻易覆盖。如果必须指定版本，使用<properties>块集中管理。

3. 配置分离：敏感配置如数据库密码不要提交到代码库，使用环境变量或外部配置文件：

   spring.datasource.password=${DB_PASSWORD}

4. 开发规范：

   • 保持pom.xml整洁，按功能分组依赖
   • 使用Spring Boot的配置提示功能（spring-boot-configuration-processor）
   • 遵循RESTful命名规范

5. 性能调优：

   • 使用@SpringBootTest时添加webEnvironment = WebEnvironment.RANDOM_PORT
   • 生产环境关闭DevTools
   • 适当调整Tomcat线程池参数

这套环境我已经在多个生产项目中验证过，从零开始搭建到第一个API运行通常不超过30分钟。关键在于每个环节的细节把控，特别是环境变量和IDE配置这些看似简单却容易出错的地方。