java extension pack 安装不全需彻底卸载后重装，优先选用 jdk 17，确保 java.home 指向 jdk 根目录；调试配置需设 "type": "java"、"request": "launch"；中文乱码须同步设置 vs code 编码、终端 java_tool_options 和 maven 构建编码。
Java Extension Pack 装不全？先卸载再装，别信“一键安装”
VS Code 里 Java 开发环境崩得最勤的，就是 Java Extension Pack 安装不完整——看着装完了，java.home 不识别、Debug 按钮灰掉、Ctrl+Click 进不去 JDK 源码。这不是你网络差，是插件依赖链没拉齐。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 彻底卸载所有 Java 相关插件（
Extension Pack for Java、Language Support for Java、Debugger for Java、Test Runner for Java、Project Manager for Java），重启 VS Code 再重装Java Extension Pack - 装完后看右下角状态栏有没有
Java图标；没有就说明核心插件（Language Support for Java）根本没启起来 - 别用国内镜像源自动安装插件——它常漏掉
Debugger for Java的 native agent 组件，导致断点无效
java.home 配置错位：不是路径问题，是 JDK 版本和插件不匹配
java.home 配错了，VS Code 会报 The java.home variable is not set 或静默失败（比如编译通过但 Run 按钮不可点）。但真正卡住人的，往往是 JDK 太新或太旧。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- VS Code 的 Java 插件目前（2024 年中）对 JDK 21 支持尚不稳定，
Debugger for Java在某些子版本下无法 attach 进程；稳妥选 JDK 17（LTS）或 JDK 20 -
java.home必须指向 JDK 根目录，不是jre/子目录，也不是bin/目录；Windows 下常见错配成C:\Program Files\Java\jdk-17.0.2\bin（少了一级） - 在 VS Code 设置里搜
java.home，填绝对路径；不要用%JAVA_HOME%或~，插件不解析环境变量
调试时断点不命中？检查 launch.json 的 "type" 和 "request"
点了 F5 启动调试，断点灰色、控制台没输出、进程一闪而过——大概率是 launch.json 里 "type" 写成了 "java"（旧写法），或 "request" 错写成 "launch" 以外的值。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 确保
.vscode/launch.json中配置项含："type": "java"（注意小写）、"request": "launch"、"mainClass"指向带public static void main的类全名（如"com.example.Hello"） - 如果项目用 Maven，别手动写
"classPaths"；插件会自动读取pom.xml，硬写反而覆盖 classpath - 断点不生效时，先运行
java -version和javac -version确认命令行用的 JDK 和java.home一致；不一致会导致字节码版本冲突，断点被跳过
中文乱码、控制台输出问号？编码设置要分三层打补丁
System.out 打印中文变 ???，Maven 控制台日志也是问号——这不是 VS Code 编码设成 UTF-8 就能解决的。Java 工具链有三处独立编码开关，漏一个就白设。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- VS Code 全局设置加：
"files.encoding": "utf8"，同时右下角点击编码按钮，确认当前文件是UTF-8（不是UTF-8 with BOM） - 在
settings.json中显式指定终端编码："terminal.integrated.env.windows": { "JAVA_TOOL_OPTIONS": "-Dfile.encoding=UTF-8" }（Windows）或对应 macOS/Linux 变量 - Maven 构建需额外加参数：在
settings.json的"java.configuration.updateBuildConfiguration": "interactive"开启后，右键pom.xml→ “Update project”，勾选Force Update of Snapshots/Releases，否则maven-compiler-plugin默认用系统编码编译
JDK 自身的默认字符集取决于启动时的 locale，但 VS Code 插件不会帮你改这个；所以靠 JAVA_TOOL_OPTIONS 注入是最直接的解法。别指望改 Windows 区域设置能一劳永逸，Java 进程启动时已经锁死了。
