VSCode Java调试失败主因是断点未注册：java.home须指向JDK根目录（非/bin或/jre），项目需被识别为Java工程（含pom.xml或src/main/java），且launch.json中必须配置preLaunchTask触发编译。
VSCode 运行 Java 调试失败，90% 是因为断点根本没注册成功——不是代码写错了，而是环境没对齐、launch.json 没生效、或 JDK 路径填成了 /bin/java 这种无效路径。
Java 断点灰色不可用？先查这三个硬性条件
断点显示为浅灰色、右键无“编辑断点”选项、F5 启动后直接闪退或报 mainClass not found，说明调试链路在最底层就断了。
- 确认已安装
Java Extension Pack（含vscode-java-debug和语言服务器），单独装Debugger for Java不行 -
java.home必须指向 JDK 根目录，例如/usr/lib/jvm/jdk-17.0.2，不能是/jre、/bin或/bin/java - 项目必须被识别为 Java 工程：根目录下要有
pom.xml、build.gradle，或至少有.project+src/main/java目录结构
launch.json 里不配 preLaunchTask，改完代码永远在跑旧 class
Java 是编译型语言，VSCode 不会自动重编译。你看到的“断点没生效”，大概率是调试器在执行上一次生成的 .class 文件。
- 在
.vscode/launch.json的调试配置中添加："preLaunchTask": "compile" - 确保
.vscode/tasks.json中存在对应label: "compile"的任务，且command指向javac或mvn compile，args包含-g（生成调试信息） - 若用 Maven，推荐 task
command设为mvn，args为["compile", "-Dmaven.compiler.debug=true"]
条件断点写错表达式，等于没设
Java 条件断点表达式必须是 JVM 运行时可求值的布尔表达式，不是 JavaScript，也不能带副作用。
立即学习“Java免费学习笔记（深入）”；
- 正确写法：
i == 5、"admin".equals(userId)、list != null && list.size() > 10 - 错误写法：
let i = 5（语法非法）、System.out.println("hit")（有副作用，不执行）、user.id == "admin"（user为 null 时抛 NPE，断点直接失效） - 右键断点 → “编辑断点” → 输入后**必须按回车确认**，光标移走不保存
- 虚拟线程场景下，建议配合
Suspend Policy: Thread，避免一断全停
变量显示 undefined 或 not available，别只盯着断点位置
这通常不是断点问题，而是调试器找不到变量符号表或作用域映射失效。
- 检查编译参数是否含
-g且不含-O2类优化；Maven 用户确认maven-compiler-plugin配置了<debug>true</debug> - 若用 Lombok，确保
lombok.config中未启用lombok.anyConstructor.addConstructorProperties = true（某些版本干扰调试符号） - 异步回调、Lambda 内部设断点时，局部变量名可能被编译器重命名（如
val$index），此时在“变量”面板里展开this或查看“表达式”窗口输入原始变量名试试
最易被忽略的是：断点设在 try 块第一行，但异常发生在 catch 或 finally 里——调试器不会跨块自动跳转，得手动在对应块里再设一个。
