VS Code Java开发必须显式配置java.home指向JDK根目录、launch.json中指定mainClass、中文路径下设置JAVA_TOOL_OPTIONS编码，三者任一缺失均导致编译失败或调试异常。
VS Code 本身不是 Java IDE，但装对扩展、配好环境后，完全可以胜任日常 Java 开发——关键不在“怎么装”，而在“哪些配置不能漏、哪些路径必须手动指定”。
Java 运行时和 JDK 路径必须显式配置
VS Code 不会自动识别系统 PATH 中的 java 或 javac，尤其当你装了多个 JDK（比如 JDK 8 和 JDK 17）时，java.home 配置错误会导致编译失败、断点不生效、甚至连 main 方法都标红。
- 在 VS Code 设置中搜索
java.home，值必须是 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home或C:\Program Files\Java\jdk-17.0.1），不能是 JRE 路径，也不能只写到bin - 验证方式：打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Java: Configure Java Runtime，检查 “Installed JDKs” 是否列出你指定的版本 - 如果项目用 Maven，还要确认
maven.executable.path指向的是mvn命令所在目录（如/opt/homebrew/bin/mvn），否则右键Run As Java Application会报 “command not found”
必须安装且启用这 3 个核心扩展
只装 Red Hat 的 Extension Pack for Java 不够，它只是合集，里面某些组件默认不激活，或者需要单独配置。
-
Language Support for Java：提供语法校验和基础补全，但依赖java.home正确才能启动后台语言服务器（JDT LS） -
Debugger for Java：断点、变量监视、表达式求值全靠它；若调试时提示 “No executable found”，大概率是java.home指向了 JRE 或路径含空格未加引号 -
Project Manager for Java：管理多模块 Maven/Gradle 项目，右键刷新依赖、生成.vscode/settings.json时才真正生效；不装它，src/main/java可能不被识别为源码根目录
运行配置（launch.json）不能依赖自动生成
VS Code 的 “Run and Debug” 面板点击 “create a launch.json file” 后生成的模板，往往缺少关键字段，导致运行失败或参数无效。
立即学习“Java免费学习笔记（深入）”；
- 最常见问题是没指定
mainClass：即使类里有public static void main(String[] args)，也必须显式写成"mainClass": "com.example.HelloWorld"，不能只靠类名自动推导 - 需要传 JVM 参数时（如
-Xmx2g），必须放在vmArgs字段，而不是args；后者只传给main方法 - 如果项目用了 Lombok，要加
"vmArgs": "-javaagent:${workspaceFolder}/lombok.jar"，且确保lombok.jar在工作区根目录下——路径错一个字符就静默失败
中文路径或文件名会导致编译乱码
这不是 VS Code 的 bug，而是 JDK 编译器默认编码与系统不一致。Windows 上尤其明显：项目路径含中文，javac 会把源文件当 GBK 解码，但 Java 源码实际是 UTF-8，结果所有中文字符串全变成 ???。
- 临时解决：在
.vscode/settings.json加"java.compile.nullAnalysis.mode": "automatic"没用，得改编译参数 - 正确做法：在
launch.json的configurations里加"env": {"JAVA_TOOL_OPTIONS": "-Dfile.encoding=UTF-8"} - 更彻底的方式：在用户级
settings.json中设置"files.encoding": "utf8"，并确保java.configuration.updateBuildConfiguration设为interactive，这样每次新建项目会提示你选编码
真正卡住人的从来不是“怎么开始”，而是 java.home 指错了 JDK、launch.json 漏了 mainClass、或者中文路径下没设 JAVA_TOOL_OPTIONS —— 这三处一错，其他配置再全也没法跑起来。
