必须显式配置 JDK 路径（java.home）并安装 Extension Pack for Java，确保 JDK 11+、main 方法签名正确、调试前已编译、launch.json 中 mainClass 为全限定名，否则语法高亮、调试等功能均失效。
VS Code 本身不内置 Java 支持，必须靠扩展和外部工具链协同工作；直接装个 Extension Pack for Java 不等于能跑起来，缺 JDK、没配置 java.home、调试器找不到主类——这些才是真卡点。
确认并指定正确的 JDK 路径（java.home）
VS Code 的 Java 扩展不会自动识别系统 PATH 里的 JDK，必须显式告诉它用哪个。Windows/macOS/Linux 表现一致：没配 java.home，项目连语法高亮都可能异常，更别说调试。
- 先在终端运行
java -version和which java（macOS/Linux）或where java（Windows），确认已安装 JDK 11 或更高版本（推荐 JDK 17 LTS） - 找到 JDK 根目录：例如 Windows 是
C:\Program Files\Java\jdk-17.0.2，macOS 是/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home - 在 VS Code 设置中搜索
java.home，填入该路径（不要带/bin）；也可在.vscode/settings.json中写："java.home": "/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home"
- 改完重启窗口，看左下角是否显示 JDK 版本号；若仍报错
The java.home variable is not set，说明路径有空格、符号或权限问题
确保 Extension Pack for Java 启用且无冲突
这个扩展包是官方维护的集合，但不是“一键开箱即用”。它依赖底层语言服务器（Java Language Server），而该服务启动失败时，VS Code 不会明确提示，只会表现为：无法跳转定义、没有自动补全、Run 按钮灰掉。
- 卸载所有其他 Java 相关扩展（如单独的
Java Extension、Red Hat Java等），只留Extension Pack for Java（含Language Support for Java、Debugger for Java、Test Runner for Java等） - 检查扩展输出面板：
Ctrl+Shift+U→ 选择Java，看是否有Failed to start the Java language server日志 - 常见原因：JDK 路径错误、磁盘空间不足、用户目录含中文或特殊字符（尤其 Windows 用户家目录在
C:\Users\张三时易出问题）
调试前必须生成 .class 文件（别指望自动编译）
VS Code 的 Java 调试器不接管构建过程，它只调用 java 命令运行已编译的类。如果你改了代码但没手动编译，断点永远不命中，控制台只报 Error: Could not find or load main class。
立即学习“Java免费学习笔记（深入）”；
- 右键 Java 文件 →
Compile Java File（生成.class），或配置保存时自动编译："java.compile.onSave.enabled": true
加入settings.json - 确认
main方法签名严格为public static void main(String[] args)；少一个static或参数名不是args都会导致启动失败 - 调试配置（
.vscode/launch.json）里mainClass必须写全限定名，例如"mainClass": "com.example.HelloWorld"，而不是文件名HelloWorld - 如果项目含多个模块或使用 Maven，优先用
Maven for Java扩展 +mvn compile，比手动编译更可靠
常见调试失败现象与对应检查点
断点不生效、控制台空白、进程秒退——这些问题几乎都源于环境链路断裂，而非代码逻辑错误。
-
Cannot connect to runtime process：调试器端口被占，或防火墙拦截；尝试关闭其他 IDE（IntelliJ/Eclipse）再试 - 断点显示为空心圆（未绑定）：源码与
.class文件不匹配，或mainClass名写错；检查out/或target/classes/下是否存在对应类文件 - 调试时变量值显示
<not available>：JDK 编译时未加-g参数（VS Code 默认开启调试信息，但若用外部命令编译则需手动加） -
中文乱码：在
launch.json的console字段设为"integratedTerminal"，并在终端设置中启用 UTF-8（"terminal.integrated.defaultProfile.linux": "bash"+ 确保 locale 是en_US.UTF-8或zh_CN.UTF-8）
最常被忽略的是：JDK 路径指向 JRE 而非 JDK，或用了从 Oracle 官网下载的仅含 JRE 的安装包；其次就是调试配置里 mainClass 写成文件名而非全限定类名——这两个点卡住的人最多。
