java extension pack 是必要起点但非终点，需配对 jdk 17+（非 jre）、正确设置 java.home 为 jdk 根目录，并配置 java.configuration.updatebuildconfiguration 等关键项以确保项目识别与运行正常。
Java Extension Pack 一定要装，但别只装它
VS Code 本身不带 Java 支持，Java Extension Pack 是起点，不是终点。它打包了 Language Support for Java、Debugger for Java、Test Runner for Java 等核心插件，但缺了 JDK 就完全跑不起来——很多人装完插件发现 public class 不高亮、Ctrl+Click 跳转失败，其实是 java.home 没配对。
- 确认已安装 JDK 17 或更高版本（JDK 21 更稳妥），不要用 JRE
- 在 VS Code 设置里搜
java.home，值必须是 JDK 根目录（如/Library/Java/JavaVirtualMachines/jdk-21.jdk/Contents/Home或C:\Program Files\Java\jdk-21），不能是bin子目录 - 如果用 SDKMAN! 或 jEnv 管理多 JDK，优先用绝对路径，避免 shell 初始化逻辑在 VS Code GUI 启动时未生效
运行单个 .java 文件：别依赖右键“Run Java”，先看终端输出
点击右键菜单里的 Run Java 很方便，但背后调的是 java 命令，不是 IDE 的完整构建流程。一旦报错 Error: Could not find or load main class，大概率是类路径或包声明没对齐。
- 确保文件名和
public class名完全一致（大小写敏感） - 如果文件在子目录（如
src/hello/Hello.java），且含package hello;，那必须从src目录下运行：java hello.Hello，而不是java Hello - VS Code 默认的运行配置不会自动加
-cp，复杂项目建议改用launch.json配mainClass和projectName，而非靠文件右键
settings.json 里这三项配置比插件还关键
很多问题不是插件没装好，而是 VS Code 自己没“认出”这是 Java 项目。光靠插件自动探测经常失效，尤其项目结构不标准时。
-
"java.configuration.updateBuildConfiguration": "interactive"—— 设为interactive才会在打开pom.xml或build.gradle时弹窗问你是否导入；设成automatic可能静默失败 -
"java.import.exclusions": ["**/node_modules/**", "**/.git/**"]—— 必须手动加，否则大项目扫描卡死，CPU 拉满 -
"editor.codeActionsOnSave": {"source.organizeImports": true}—— 开启后保存自动整理 import，但注意它依赖Language Support for Java的索引完成，首次打开项目可能要等几秒才生效
Maven 项目启动失败？先检查 .vscode/settings.json 是否覆盖了根配置
VS Code 允许工作区级（.vscode/settings.json）和用户级设置共存，而 Maven 插件的 java.project.sourcePaths 很容易被工作区配置误覆盖，导致找不到 src/main/java。
立即学习“Java免费学习笔记（深入）”；
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Java: Configure Classpath，看列出的 source path 是否包含预期目录 - 如果
.vscode/settings.json里有"java.project.sourcePaths"，且值是空数组或错误路径，删掉这一行——让插件自动推导更可靠 - Maven 多模块项目中，父
pom.xml所在目录必须是 VS Code 的打开根目录，否则子模块的依赖不会被统一索引
真正卡住人的，往往不是“该装什么”，而是 JDK 路径写错半格斜杠、package 声明和目录没对齐、或者工作区配置悄悄屏蔽了自动识别。这些地方没报错提示，只表现为你改了代码，但 Ctrl+Hover 不显示类型，或者断点根本进不去。
