在Windows上搭建Java与Spring Boot环境，很多人第一次尝试时会卡在环境变量配置或Maven依赖下载上。其实整个流程可以拆解成四个环节：安装JDK、配置系统变量、安装Maven、创建并运行Spring Boot项目。把这四步理清后，后续开发会顺畅很多。下面先从JDK开始。
一、安装JDK并配置Windows环境变量
JDK是Java Development Kit的缩写，Spring Boot项目必须依赖它才能编译和运行。目前主流的长期支持版本是JDK 17，如果你的项目还停留在JDK 8或JDK 11，也可以按同样步骤处理。先到Oracle官网或OpenJDK发行版页面下载Windows安装包，这里以解压版为例，因为解压版不写注册表，后续切换版本更方便。假设解压到了C:\Program Files\Java\jdk-17，这个路径后面要反复用到。
配置环境变量时，需要新建一个名为JAVA_HOME的系统变量，值就是JDK的安装路径，例如C:\Program Files\Java\jdk-17。注意路径里用的是反斜杠\而不是斜杠/，这是Windows系统的规则。接着找到系统变量中的Path，点击编辑，新增一条%JAVA_HOME%\bin。这里的%JAVA_HOME%会引用之前定义的变量，这样以后升级JDK时只需要修改JAVA_HOME的值，不必再动Path。
修改完成后打开新的命令提示符窗口，输入java -version和javac -version。如果屏幕上显示出JDK版本号，说明配置成功。有些电脑上需要重启命令提示符甚至重启系统才能生效，原因是旧的进程仍缓存着修改前的环境变量。另外，如果之前安装过旧版JDK，可能存在多个java.exe在Path中，可以用where java查看实际调用的路径，确保它指向你刚配置的版本。
二、安装Maven并配置本地仓库
Spring Boot官方推荐使用Maven或Gradle作为构建工具，其中Maven使用率更高，配置也相对直观。下载Maven的二进制压缩包，解压到C:\Apache\Maven之类的目录。接着同样设置环境变量：新建MAVEN_HOME，值为C:\Apache\Maven；然后在Path中追加%MAVEN_HOME%\bin。验证方式是在命令行输入mvn -v，能看到Maven版本和它所使用的JDK路径。
Maven默认会把依赖下载到用户目录下的.m2文件夹，完整路径类似C:\Users\你的用户名\.m2\repository。如果C盘空间紧张，可以修改conf\settings.xml文件，在<settings>标签内添加<localRepository>节点，把本地仓库指向其他盘，比如D:\MavenRepo。这个操作不是必须的，但对长期开发很有帮助，能避免C盘被依赖包占满。
国内网络环境下，从Maven中央仓库下载依赖可能很慢甚至超时。这时可以在settings.xml里配置镜像源，把请求转发到阿里云等公共镜像。具体做法是在<mirrors>内添加一个<mirror>，mirrorOf设置为central，url填写镜像地址。配置完成后再次执行mvn命令，下载速度会有明显提升。
三、创建并运行第一个Spring Boot项目
有了JDK和Maven，就可以正式创建Spring Boot应用了。最简单的办法是使用Spring Initializr网站生成项目骨架，选择Maven、Java版本、Spring Boot版本以及需要的依赖，比如Spring Web。下载后解压到本地目录，例如D:\Projects\demo。进入该目录，在地址栏输入cmd直接打开命令提示符，执行mvn spring-boot:run。第一次运行会下载所有相关依赖，耗时取决于网络状况。
项目启动成功后，控制台会输出类似Tomcat started on port 8080的日志。此时打开浏览器访问http://localhost:8080，如果看到默认的Whitelabel错误页面，说明Web容器已经正常工作，只是还没有定义任何接口。为了验证整个链路，可以在src\main\java对应的包下新建一个Controller类，例如下面的代码：
package com.example.demo;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class HelloController {
@GetMapping("/hello")
public String hello() {
return "Hello from Spring Boot on Windows";
}
}
保存文件后重新运行mvn spring-boot:run，这次再访问http://localhost:8080/hello，页面会显示那段欢迎文本。这里要注意src\main\java中的路径分隔符是反斜杠，因为这是Windows文件系统下的真实目录结构。如果你用的是IDE，比如IntelliJ IDEA，它会自动识别Maven项目并生成运行配置，省去手动敲命令的步骤。
另一个常见问题是端口被占用。如果8080端口已经启动过其他服务，Spring Boot会启动失败并抛出Port already in use异常。此时可以在src\main\resources\application.properties文件中添加server.port=8081，然后重新运行。这个配置文件是Spring Boot外部化配置的核心，后面很多自定义参数都可以写在这里。
四、常见问题排查与版本切换
环境搭建过程中最让人困扰的是“明明装好了，为什么命令不识别”。这类问题十有八九是环境变量没有生效，或者Path里存在多个冲突的JDK或Maven路径。排查时先执行echo %JAVA_HOME%和echo %MAVEN_HOME%，确认变量值正确。然后执行where java和where mvn，看系统实际找到的是哪一份可执行文件。如果路径不对，说明Path中靠前的条目指向了旧版本，调整顺序或删除旧条目即可。
当你需要在多个JDK版本之间切换时，不必反复修改环境变量，可以通过临时设置命令来覆盖。例如在命令行执行set JAVA_HOME=C:\Program Files\Java\jdk-11，再执行set Path=%JAVA_HOME%\bin;%Path%，这条命令只在当前窗口生效。对于Spring Boot 2.x老项目，可能必须使用JDK 8或11，而新项目又要求JDK 17，这种方式能快速适配。
如果Maven下载依赖一直失败，除了检查网络和镜像配置，还可以尝试清空本地仓库中不完整的下载文件。它们通常位于D:\MavenRepo或C:\Users\你的用户名\.m2\repository下，删除对应目录后重新执行mvn clean package。有时候是防火墙或代理阻止了HTTPS请求，需要在settings.xml中配置代理服务器。对于公司内网环境，这一点尤其常见。
最后，建议把整个JDK、Maven和项目目录都放在没有中文字符和空格的路径下。例如C:\Java\jdk-17而不是C:\程序文件\Java 17。虽然新版工具对空格和中文兼容性已经改善很多，但一些老旧的依赖或脚本仍可能因为路径解析出错而失败。保持路径简洁干净，能减少大量无谓的排查时间。
Java环境搭建Spring BootWindows配置修改时间：2026-09-20 12:22:56