VSCode能完整替代IDEA做Java开发，但必须手动对齐JDK、Maven和插件三者的路径与版本；否则会出现pom.xml识别失败、Run按钮灰掉、ClassNotFoundException等问题。
VSCode 能完整替代 IDEA 做 Java 开发，但必须手动对齐 JDK、Maven 和插件三者的路径与版本，缺一不可；否则会出现 pom.xml 识别失败、Run 按钮灰掉、java.lang.ClassNotFoundException 等典型问题。
确认 JDK 已正确安装并被 VSCode 识别
VSCode 的 Java 插件不读系统 JAVA_HOME，它依赖自己的配置项。即使终端里 java -version 输出正常，VSCode 仍可能用错 JDK。
- 打开命令面板（
Ctrl+Shift+P），输入Java: Configure Java Runtime，选中你本地的 JDK 17 或 JDK 21（JDK 8/11 已不推荐） - 如果列表为空，说明插件没扫描到 JDK：手动编辑
settings.json，添加"java.home": "C:\Program Files\Eclipse Adoptium\jdk-17.0.9+9"（Windows）或"java.home": "/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home"（macOS） - 关键验证点：打开任意
.java文件，右下角状态栏应显示类似Java 17的版本号；若显示Java (unresolved)，说明配置失败
让 Maven 命令和 pom.xml 同步生效
VSCode 的 Maven for Java 插件不是“装完就自动好”，它需要明确知道 mvn 可执行文件在哪，且项目根目录下必须有合法的 pom.xml。
- 在设置中搜索
maven.executable.path，填入你本地 Maven 的mvn或mvn.cmd全路径（如D:\apache-maven-3.9.6\bin\mvn.cmd） - 不要只靠插件自动生成项目——先确保终端能跑通
mvn -v，再在 VSCode 里用Maven: Create Maven Project；否则生成的pom.xml可能缺<packaging>jar</packaging>导致构建失败 - 新建项目后，务必等待左下角出现 “Resolving dependencies…” 提示结束，再打开
pom.xml—— 过早操作会导致依赖树不加载，Maven 侧边栏空白
运行和调试时 classpath 错误的常见来源
点击 Run 按钮报 ClassNotFoundException 或调试时断点不触发，大概率是类路径没对齐，而非代码写错。
立即学习“Java免费学习笔记（深入）”；
- 确保主类位于
src/main/java下，且包声明与目录结构严格一致（例如package com.example;必须对应src/main/java/com/example/App.java） - 检查
launch.json中的"mainClass"字段是否拼写准确，大小写敏感，且不含.java后缀 - 如果用了模块化（
module-info.java），需额外在launch.json中加"vmArgs": "--add-modules ALL-SYSTEM"，否则 JVM 启动直接失败
最易被忽略的一点：VSCode 的 Java 语言服务器（JDT LS）会缓存项目结构。一旦改过 pom.xml 里的 <sourceDirectory> 或新增了 src/main/kotlin 这类非标准源目录，必须手动触发 Java: Clean the Java language server workspace，否则所有补全、跳转、运行功能都会滞后甚至失效。
