VSCode运行Java Web需安装Microsoft的Extension Pack for Java并完全重启，再启用Red Hat的Spring Boot Tools，配置正确launch.json及UTF-8编码的application.properties。
VSCode 本身不带 Java Web 运行能力，必须靠扩展补全语言支持、构建链路和 Spring Boot 特性识别——缺任意一环，就会出现 Cannot resolve symbol 'SpringBootApplication'、右键无“Run”选项、断点不生效或 Failed to load property source from location 'classpath:/application.properties'。
Extension Pack for Java 必须装全且重启
很多人只装了“Java”关键词的插件，结果代码不提示、@Autowired 标红、SpringBootApplication 解析失败。真正起作用的是 Microsoft 官方的 Extension Pack for Java，它打包了：Language Support for Java（语法分析）、Debugger for Java（调试通道）、Test Runner for Java（测试支持）等。漏掉任一子项，VSCode 就无法把 .java 文件当 Java 项目处理。
- 在扩展市场搜
Extension Pack for Java，认准发布者是 Microsoft，名称带Extension Pack字样 - 安装后必须 完全重启 VSCode 窗口（不是重载窗口），否则插件不激活
- 如果项目已打开，删掉根目录下的
.vscode/文件夹再重启，避免旧缓存干扰 - 重启后打开任意
.java文件，右下角状态栏应显示Java 17或对应版本；若显示Java (unresolved)，说明插件未加载成功
Spring Boot Tools 要单独启用并刷新项目
Spring Boot Extension Pack 是个合集，但真正提供 application.yml 补全、Actuator 端点识别、Dashboard 视图的是其中的 Spring Boot Tools 子模块——它由 Red Hat 维护，必须手动启用且版本匹配当前 Spring Boot。
- 扩展面板中搜索
Spring Boot Tools，确认发布者是 Red Hat，安装后点击Reload - 打开含
pom.xml的项目根目录，等待右下角弹出Spring Boot project detected - 若没提示，点击左侧 Spring Boot 图标（叶子徽标）→ 右键空白区 →
Refresh Spring Boot Projects - Dashboard 不显示模块？检查
pom.xml中是否含spring-boot-starter-web（<scope>不能是test）
launch.json 配置比右键运行更可靠
图形化右键菜单看似方便，但传参能力弱、环境隔离差，且容易因 projectName 与 pom.xml 中不一致而静默失败。真要稳定运行、设断点、传参数，必须手写 .vscode/launch.json。
立即学习“Java免费学习笔记（深入）”；
-
mainClass必须写全限定名，如com.example.demo.DemoApplication，包名错一个字母就ClassNotFoundException -
args字段只放程序参数（如--server.port=8081），JVM 参数要用vmArgs（如"vmArgs": "-Xmx512m"） -
projectName必须严格等于pom.xml中的<artifactId>，大小写敏感；否则 classpath 错位，断点变空心圆 - 首次启动前，终端执行
mvn compile，确保target/classes/已生成，否则调试器找不到字节码
application.properties 编码和路径最容易被忽略
90% 的配置不生效问题，不是内容写错了，而是文件没被 Spring Boot 当作资源加载——关键在位置和编码。
- 文件必须放在
src/main/resources/下，不能在src/main/java/或resources/config/子目录里 - 用命令行检查编码：
file -i src/main/resources/application.properties，输出必须含charset=utf-8；Windows 下复制过来常带 BOM，需用 VSCode 右下角编码切换为UTF-8并保存 - 如果用了 Lombok，确保
pom.xml中lombok依赖的<scope>是provided，且 VSCode 设置中启用了 annotation processing - 修改完配置后，不要只点“运行”，先确认
mvn spring-boot:run在终端能正常启动——排除项目本身问题
最麻烦的不是配置步骤多，而是每个环节都依赖上一个环节生效：插件没装全 → 项目不识别 → launch.json 生成错误 → 断点无效 → 最后以为是代码问题。建议按顺序逐项验证，别跳步。
