跳转到主内容
趣航编程网 - 趣学编程,启航技术之路!

怎样在VSCode中配置Java开发与Spring Boot项目【教程】

VSCode 可胜任 Spring Boot 开发,关键在于 java.home、spring-boot-dashboard 和 Language Support for Java 三者对齐:需手动配置 JDK 路径、安装三大核心扩展、用离线方式初始化项目、正确设置 launch.json 与 application.yml 端口、启用 DevTools 并清理语言服务器缓存。 VSCode 本身不是 Java IDE,但通过正确配置扩展和工具链,完全可以胜任 Spring Boot 开发——关键不在“能不能”,而在「
java.home
、
spring-boot-dashboard
和
Language Support for Java
三者是否对齐」。 确认 JDK 已安装且被 VSCode 识别 VSCode 不自带 JDK,必须手动指定路径。如果
java -version
在终端能正常输出,不代表 VSCode 能自动找到它。 在 VSCode 中按
Ctrl+Shift+P
(Windows/Linux)或
Cmd+Shift+P
( mac OS),输入
Java: Configure Java Runtime
,进入设置页 在
Java Runtime Configuration
页面中,检查
Default JRE
是否指向你期望的 JDK(如
/usr/lib/jvm/java-17-openjdk-amd64
或
C:\Program Files\Java\jdk-17.0.2
) 若为空或错误,点击
+ Add JDK
,手动选择 JDK 根目录(不是
bin
子目录) 重启 VSCode 后,打开一个
.java
文件,看右下角状态栏是否显示 JDK 版本;若显示
Java (unresolved)
或报错
The JAVA_HOME environment variable does not point to a valid JVM installation
,说明路径未生效 安装并验证核心扩展组合 仅装
Extension Pack for Java
不够,Spring Boot 项目依赖额外支持。缺一不可:
Language Support for Java
:提供基础语法校验、跳转、补全(由 Red Hat 维护)
Debugger for Java
:运行/调试 Java 类,必须启用
java.debug.settings.launch.args
才能传参给 Spring Boot
Spring Boot Extension Pack
:含
Spring Boot Dashboard
(可视化启动/停止)、
Spring Boot Tools
(
@Autowired
提示、
application.properties
高亮) 禁用冲突扩展:如
Java Test Runner
若与
Test Explorer UI
冲突,会导致测试图标不显示 初始化 Spring Boot 项目时绕过 Maven 卡死 VSCode 内置的
Spring Initializr
(通过
Ctrl+Shift+P → Spring Initializr: Generate a Maven Project
)本质是调用
start.spring.io
API。国内用户常卡在 “Generating project…” 无响应。 通义灵码 windows版 通义灵码 0.8.0 是一款面向智能开发场景的轻量级集成开发环境。该版本聚焦效率与协作,提供代码智能补全、实时语法检查与版本管理功能,并优化了插件扩展能力,适配主流编程语言。0.8.0 版本进一步提升了启动速度与界面响应流畅度,内置任务运行器与调试工具,帮助开发者更快捷地完成项目构建与问题定位。简洁、现代的设计让初学者与专业团队都能快速上手。 下载 立即学习 “ Java免费学习笔记(深入) ”; 先确保网络可访问
https://start.spring.io
;不行就改用离线方式:
curl https://start.spring.io/starter.zip -o demo.zip
下载后解压导入 导入项目后,首次加载会触发 Maven 下载依赖,VSCode 右下角出现
Downloading dependencies...
—— 此时不要关窗口,否则
.project
元数据损坏,需删掉
.vscode
目录重来 若
pom.xml
报红(如
org.springframework.boot:spring-boot-starter-web
unresolved),检查
settings.json
中是否误加了
"maven.executable.path"
指向旧版 Maven;建议留空,让插件用内置
maven-wrapper
调试 Spring Boot 应用时注意端口与配置优先级 直接点右上角 ▶️ 运行
Application.java
往往失败,因为 Spring Boot 默认读取
application.properties
的
server.port
,而 VSCode 调试器可能覆盖它。 在
.vscode/launch.json
中,确保
configurations
包含
"request": "launch"
和
"mainClass": "com.example.demo.DemoApplication"
如需指定端口,不要写死在
launch.json
的
args
里,而应在
application.yml
中设
server.port: 8081
,或通过
env
字段注入:
"env": {"SERVER_PORT": "8081"}
修改
application.properties
后,热更新不一定生效——Spring Boot DevTools 需要额外配置:
spring.devtools.restart.enabled=true
,且 VSCode 的文件保存必须触发编译(检查
Java Build Path
是否启用
Build automatically
) 最易忽略的是:VSCode 的 Java 插件会缓存项目结构,一旦
pom.xml
增加新依赖,必须手动执行
Java: Clean the Java language server workspace
,否则新类无法 import、注解不识别。这不是 bug,是设计使然。

相关文章