launch.json配置不生效的根本原因是未触发Java调试支持，需确保项目含pom.xml或build.gradle、type为"java"、mainClass用全限定名，且重载窗口；断点失效多因classpath与源码路径不匹配。
为什么 launch.json 配置不生效？
VSCode 的 Java 调试依赖于 .vscode/launch.json，但很多项目里它“写了却没用”——根本原因是没触发正确的启动类型。Java Extension Pack（由 Red Hat 提供）默认只在识别到 main 方法且项目结构符合 Maven/Gradle 规范时，才自动启用调试支持。
- 确保项目根目录下有
pom.xml或build.gradle，否则插件可能不加载调试器 - 如果手动创建了
launch.json，检查type字段必须是"java"，不是"node"或空字符串 -
mainClass必须写全限定名（如"com.example.App"），不能只写类名或带.java后缀 - 修改后需关闭再重开文件夹，或点击调试面板右上角齿轮图标 → “重新加载窗口”
断点不命中？先查 classpath 和源码匹配
断点灰色、提示“未绑定”或跳过执行，90% 是 classpath 与源码路径不一致导致的。VSCode 调试器运行的是编译后的 .class，但它需要准确映射回你编辑的 .java 文件。
- 检查
out/production/（IntelliJ 风格）或target/classes/（Maven）是否被正确加入 classpath；VSCode 默认读取target/classes，若你用的是 Gradle，要确认build/classes/java/main是否在classpath中 - 在
launch.json中显式指定projectName（对应 Maven 模块名）或classpath数组，避免插件猜错 - 如果用了 Lombok，确保已安装并启用
Lombok Annotations Support for VS Code插件，否则生成的 getter/setter 断点无法停住
如何调试 JUnit 测试方法？
直接右键单个测试方法 → “Debug ‘Test#methodName’” 最省事，但背后依赖两个条件：测试类必须被识别为 JUnit（含 @Test 注解且依赖存在），且测试运行器能被定位。
- Maven 项目需在
pom.xml中声明junit-jupiter（5.x）或junit（4.x），仅写依赖不够，还要保证没有版本冲突（比如同时引入junit4 和 5 的 API） - 若右键无调试选项，尝试在测试类中加一个空的
public static void main(String[] args)，然后对它打断点——这是绕过测试框架识别失败的临时办法 - 对参数化测试（
@ParameterizedTest），VSCode 当前（v1.90）仍不支持逐个参数调试，只能进到方法体第一行
远程调试连接不上 localhost:5005 怎么办？
Java 远程调试本质是 JVM 启动时加 -agentlib:jdwp=... 参数，VSCode 只是客户端。连不上通常不是 VSCode 问题，而是服务端未就绪或网络策略拦截。
立即学习“Java免费学习笔记（深入）”；
- 启动命令必须包含完整 JDWP 参数，例如：
java -agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=<em>:5005 -jar app.jar</em>；注意address=:5005（允许外部连接）而非localhost:5005（仅本机） - Windows 上杀毒软件或防火墙常拦截 5005 端口，临时关闭或添加例外
- 在
launch.json中配置远程调试时，hostName填"localhost"即可，但port必须和 JVM 启动参数里的一致，且不能被占用（可用netstat -ano | findstr :5005检查）
调试 Java 项目最耗时间的环节往往不在代码逻辑，而在 classpath 对齐、JVM 参数拼写、以及插件对构建工具的隐式假设——这些细节不报错，但让断点彻底失效。
