Java调试需同时安装redhat.java和vscode-java-debug，配置JAVA_HOME指向JDK 11+，launch.json中mainClass须写全限定名，Maven项目自动解析classpath，断点失效常因源码路径与class文件不匹配，远程调试需JVM启动时添加-agentlib:jdwp参数。
Java Extension Pack 装全了没？
VSCode 本身不带 Java 调试能力，必须靠 redhat.java（Language Support for Java™）和 vscjava.vscode-java-debug 这两个扩展协同工作。少一个，F5 按下去直接报错 No debug adapter found。
- 确认已安装：打开 Extensions 面板搜
Java Extension Pack，点 Install（它会自动带齐依赖）
- 单独装
vscode-java-debug 但没装 redhat.java？不行——前者依赖后者提供的语言服务器
- Windows/macOS/Linux 都要额外配好
JAVA_HOME，且指向 JDK 11+（JDK 8 不再被 vscode-java-debug 支持）
launch.json 的 mainClass 和 classpath 怎么填？
VSCode 不像 IntelliJ 那样自动识别主类，launch.json 里 mainClass 必须写全限定名（比如 com.example.App），不能只写 App；否则报错 Could not find or load main class App。
-
mainClass 值必须与源码中 public static void main(String[] args) 所在类的包声明完全一致
- 如果项目用了 Maven，且
src/main/java 下有 com/example/App.java，那 mainClass 就是 com.example.App
-
classpath 通常不用手动写——只要项目根目录有 pom.xml 或 build.gradle，插件会自动解析依赖；手动加反而容易重复或漏掉模块路径
断点不生效？检查编译输出路径和源码匹配
常见现象：打了断点，F5 启动后断点变空心圆，悬停提示 Breakpoint ignored because generated code not found。
- 核心原因：调试器加载的是 class 文件，但 VSCode 找不到对应的源码（.java）或源码路径和 class 文件的包结构不一致
- Maven 项目默认编译到
target/classes，确保 launch.json 中 projectName 或 classPaths 指向正确位置
- 如果用
javac 手动编译，务必加 -g 参数（生成调试信息），否则断点无效
- 修改过包名或移动过 .java 文件？删掉
target/classes 重新 mvn compile，再重启 VSCode（缓存有时不自动刷新）
远程调试连不上？别漏掉 -agentlib 参数
本地调试走的是 launch 模式，远程调试（attach 到已有 JVM 进程）必须让目标 JVM 启动时带上 JDWP agent。
- 启动 Java 程序时加参数：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
- VSCode 侧
launch.json 类型设为 java，request 设为 attach，hostName 和 port 对应上
-
suspend=n 表示不阻塞启动；如果设成 suspend=y，进程会卡住等调试器连接，超时可能直接退出
- 注意防火墙：Linux/macOS 上
address=*:5005 可能被拦截，临时关掉或加规则；Windows WSL 场景下还要确认端口是否映射出来
Java Extension Pack，点 Install（它会自动带齐依赖）vscode-java-debug 但没装 redhat.java？不行——前者依赖后者提供的语言服务器JAVA_HOME，且指向 JDK 11+（JDK 8 不再被 vscode-java-debug 支持）launch.json 里 mainClass 必须写全限定名（比如 com.example.App），不能只写 App；否则报错 Could not find or load main class App。
-
mainClass值必须与源码中public static void main(String[] args)所在类的包声明完全一致 - 如果项目用了 Maven，且
src/main/java下有com/example/App.java，那mainClass就是com.example.App -
classpath通常不用手动写——只要项目根目录有pom.xml或build.gradle，插件会自动解析依赖；手动加反而容易重复或漏掉模块路径
断点不生效？检查编译输出路径和源码匹配
常见现象：打了断点，F5 启动后断点变空心圆，悬停提示 Breakpoint ignored because generated code not found。
- 核心原因：调试器加载的是 class 文件，但 VSCode 找不到对应的源码（.java）或源码路径和 class 文件的包结构不一致
- Maven 项目默认编译到
target/classes，确保 launch.json 中 projectName 或 classPaths 指向正确位置
- 如果用
javac 手动编译，务必加 -g 参数（生成调试信息），否则断点无效
- 修改过包名或移动过 .java 文件？删掉
target/classes 重新 mvn compile，再重启 VSCode（缓存有时不自动刷新）
远程调试连不上？别漏掉 -agentlib 参数
本地调试走的是 launch 模式，远程调试（attach 到已有 JVM 进程）必须让目标 JVM 启动时带上 JDWP agent。
- 启动 Java 程序时加参数：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005
- VSCode 侧
launch.json 类型设为 java，request 设为 attach，hostName 和 port 对应上
-
suspend=n 表示不阻塞启动；如果设成 suspend=y，进程会卡住等调试器连接，超时可能直接退出
- 注意防火墙：Linux/macOS 上
address=*:5005 可能被拦截，临时关掉或加规则；Windows WSL 场景下还要确认端口是否映射出来
target/classes，确保 launch.json 中 projectName 或 classPaths 指向正确位置javac 手动编译，务必加 -g 参数（生成调试信息），否则断点无效target/classes 重新 mvn compile，再重启 VSCode（缓存有时不自动刷新）- 启动 Java 程序时加参数：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=*:5005 - VSCode 侧
launch.json类型设为java，request设为attach，hostName和port对应上 -
suspend=n表示不阻塞启动；如果设成suspend=y，进程会卡住等调试器连接，超时可能直接退出 - 注意防火墙：Linux/macOS 上
address=*:5005可能被拦截，临时关掉或加规则；Windows WSL 场景下还要确认端口是否映射出来
调试 Java 最麻烦的从来不是按 F5，而是 classpath、源码路径、JVM 启动参数这三者对不齐。尤其当项目从 Eclipse 或 IDEA 迁移过来，旧配置残留、输出目录自定义、多模块路径嵌套，最容易在这里卡住半天。
