vscode 运行 java 需显式配置 java.home 绝对路径并重启，项目须含 pom.xml 或 build.gradle 才被识别，launch.json 中 mainclass 必须写全限定类名而非路径，条件断点仅支持合法 java 表达式，所有配置变更均需完全重启生效。
VSCode 能跑 Java，但不是装完扩展就自动好用——ClassNotFoundException、断点灰色不生效、No source found for main 这些报错背后，几乎全是配置链路断在某个环节。关键不在“有没有装”，而在“路径对不对、识别准不准、launch.json 里写没写错”。
java.home 必须显式配置，且不能依赖系统 JAVA_HOME
VSCode 的 Java 扩展默认不读取系统 JAVA_HOME 环境变量，哪怕终端里 java -version 和 javac -version 都正常，VSCode 仍可能找不到 JDK。
- 打开设置（
Ctrl+,），搜索java.home，点击“在 settings.json 中编辑” - 填入绝对路径，例如：
"java.home": "/Library/Java/JavaVirtualMachines/jdk-21.0.2.jdk/Contents/Home"（macOS）或"java.home": "C:/Progra~1/Java/jdk-21.0.2"（Windows，避免空格和反斜杠） - 改完必须重启 VSCode，否则新配置不加载
- 验证方式：调出命令面板（
Ctrl+Shift+P），运行Java: Configure Java Runtime，确认列表中该路径状态为Valid
项目没被识别为 Java 项目，语法高亮和调试全失效
VSCode 不会因为文件夹里有 .java 就自动当 Java 项目处理。它只认标准结构或显式声明。
- 根目录必须含
pom.xml（Maven）或build.gradle（Gradle），否则 Project Manager for Java 扩展无法激活 - 单文件调试？别直接右键 Run —— 先执行
Java: Create Java Project命令，生成.vscode/settings.json和bin/目录，否则mainClass查找不到类 - 手动创建项目后，检查状态栏左下角是否出现 Java 图标；若仍有红色波浪线，右键任意
.java文件 →Java: Configure Classpath→ 选Create new classpath configuration
launch.json 里 mainClass 写错，断点永远不触发
VSCode 自动生成的 launch.json 经常把 mainClass 设成路径形式（如 src/HelloWorld），这是典型错误——它要的是**类名全限定名**，不是文件路径。
-
mainClass值应为HelloWorld（无.java，无src/，无包前缀；若在包内则需写完整，如com.example.HelloWorld） - 多模块 Maven 项目容易漏掉
projectName字段，导致 classpath 加载失败，调试启动报Could not find or load main class - 手动加
classpath时，路径含空格或中文必须用双引号包裹，否则 JVM 启动直接失败 - 调试前务必确认：当前打开的文件是主类，且光标在
main方法内，否则断点可能被忽略
条件断点设了但不生效，其实是表达式语法不兼容
VSCode 的 Java 调试器基于 JDI 协议，条件断点表达式必须是 JVM 可求值的 Java 表达式，不能写 JS 风格或带 IDE 特有变量。
- 支持：
i == 5、list != null && list.size() > 0、str.contains("error") - 不支持：
i === 5（JS 严格相等）、console.log(...)、this.fieldName（若字段非 public 或未初始化） - 右键行号 → “Edit Breakpoint” → 输入表达式 → 勾选 “Condition” 即可启用；注意断点图标会从实心圆变成带问号的圆圈
- 若表达式引用了尚未初始化的局部变量，断点会被跳过，不会报错，容易误判为“没生效”
最常被忽略的一点：所有配置变更（尤其是 java.home 和 launch.json）都要求 VSCode 完全重启，热重载不生效。哪怕只改了一个斜杠，也得关掉再开——这是 Java 扩展底层语言服务器的硬性限制。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
