必须检查三件事：一是java.home指向含javac的JDK根目录而非JRE或bin子目录；二是打开的是含pom.xml/src/的文件夹而非单个.java文件；三是Maven项目需确保pom.xml在工作区根目录且packaging为jar或war。
Java Extension Pack装完还是不能运行代码？检查这三件事
装了 Java Extension Pack 却点不了“运行”按钮，或者按 Ctrl+F11 没反应——大概率不是插件没装好，而是底层环境没被 VS Code 正确识别。
-
java -version在终端能执行，不代表 VS Code 能读到：Windows 用户常因系统 PATH 里是 JRE 不是 JDK（缺javac），Mac/Linux 用户可能用了 SDKMAN 或 Homebrew 安装的 JDK，但 VS Code 启动方式绕过了 shell 配置 - VS Code 的 Java 插件依赖
java.home设置：必须指向含bin/javac的 JDK 根目录，不能只写到bin下或指向 JRE - 打开的是文件夹（
File > Open Folder），不是单个.java文件：插件只在工作区根目录下检测src/或pom.xml/build.gradle后才激活完整功能
vscode-java 插件报 “The java.home variable is not set” 怎么填
这个提示不是让你随便选个 JDK 路径糊弄过去。填错会导致编译失败、断点不生效、甚至 System.out.println 输出乱码。
- Windows：找你实际安装的 JDK，比如
C:\Program Files\Java\jdk-17.0.2，别选jre子目录，也别选jdk-17.0.2\bin - macOS：用
/usr/libexec/java_home -v 17查路径，结果通常是/Library/Java/JavaVirtualMachines/jdk-17.0.2.jdk/Contents/Home；如果用 SDKMAN，路径类似~/.sdkman/candidates/java/current - Linux：确认
$JAVA_HOME指向正确位置后，在 VS Code 设置里搜java.home，粘贴完整路径（注意波浪号~不会被展开，得写成绝对路径）
为什么 Maven 项目里 run 按钮还是灰色？
灰色 = 插件没识别出这是 Java 项目。不是所有带 pom.xml 的文件夹都能自动启用 Java 支持。
- 确保
pom.xml在工作区根目录，而不是嵌套在子文件夹里；如果项目结构是myproject/backend/pom.xml，就该打开backend文件夹，不是myproject - 检查
pom.xml是否有<packaging>jar</packaging>或<packaging>war</packaging>，空的或pom类型不会触发 Java 运行支持 - 右下角状态栏看有没有 “Java Projects” 提示；没有的话，点它手动刷新，或执行命令
Java: Refresh Project（Ctrl+Shift+P 输入）
中文输出乱码、控制台显示问号怎么办
这不是字体问题，是 VS Code 终端和 Java 编译器默认编码不一致导致的，尤其 Windows 默认 GBK，而 Java 源码多为 UTF-8。
立即学习“Java免费学习笔记（深入）”；
- 在 VS Code 设置里搜
files.encoding，设为utf8；再搜terminal.integrated.env，给 Windows 加上"chcp 65001"（启动终端时切编码） - Java 编译参数要显式指定：在
settings.json里加"java.configuration.updateBuildConfiguration": "interactive"，然后右键pom.xml→ “Update project”，让插件读取<properties><project.build.sourceencoding>UTF-8</project.build.sourceencoding></properties> - 如果用
System.out打印中文仍乱码，检查类文件本身是否保存为 UTF-8（右下角状态栏点编码 → “Save with Encoding” → UTF-8）
最麻烦的其实是 JDK 版本混用：VS Code 用 JDK 17 写代码，Maven 配置里却写了 11，或者 java.home 指向一个版本，而 pom.xml 的 maven-compiler-plugin 又设另一个版本——这种错位不会报错，但某些语法（比如 var、record）会悄悄失效。
