java自动导入需满足四要素：安装完整java extension pack（含redhat.java等5组件）、配置"java.suggest.autoimports": true和"java.configuration.updatebuildconfiguration": "interactive"、确保jdk路径正确且maven/gradle项目被识别、在代码补全时触发（非保存时）。
java.suggest.autoImports 必须为 true，且 Java Extension Pack 已完整安装——只装单个扩展或漏掉 vscode-java-debug 等依赖，自动导入就完全不触发。
Java Extension Pack 没装全，语言服务器压根不启动
VSCode 自身不带 Java 语义能力，所有自动导入、跳转、类型提示都靠 redhat.java 提供的语言服务器（JLS）。它不是独立插件，而是 Java Extension Pack 的核心组件，该包还强制依赖 vscode-java-debug 和 vscode-java-test。
常见错误现象：
- 状态栏右下角显示
Plain Text或无 Java 图标 -
Ctrl+Shift+P输入Java: Restart Language Server找不到命令 - 打开
Developer: Toggle Developer Tools→ Console，看到Cannot find module 'java'报错
实操建议：
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 卸载所有单独的 Java 相关扩展（如只装了 “Language Support for Java™”）
- 在扩展市场搜索
Java Extension Pack，安装官方 Red Hat 发布的完整包（含 5 个子扩展） - 重启 VSCode 后，确认状态栏出现
Java 17或对应 JDK 版本标识
settings.json 里写错了配置项名或值类型
自动导入开关是 "java.suggest.autoImports": true，不是 autoImport（少个 s）、也不是 "true"（字符串无效）。
另一个关键配置 "java.configuration.updateBuildConfiguration" 必须设为 "interactive"（字符串），不能是 true 或 "always"——只有 interactive 才会让 JLS 主动读取 pom.xml 或 build.gradle 并构建完整 classpath。
实操建议：
- 打开
Preferences: Open Settings (JSON) - 确认存在且拼写准确：
{
"java.suggest.autoImports": true,
"java.configuration.updateBuildConfiguration": "interactive",
"java.home": "/path/to/jdk-17"
}
- 改完保存，必须执行
Java: Restart Language Server（不是重启窗口）
Maven/Gradle 项目没被正确识别，classpath 是空的
即使配置全对，如果 VSCode 没加载到依赖，List、SpringApplication 这类符号照样标红、无法导入。根本原因是 JLS 没解析出有效 classpath。
常见原因：
- 项目根目录下没有
pom.xml（Maven）或build.gradle（Gradle） -
pom.xml里没声明<dependencies></dependencies>，或<parent></parent>指向的父 POM 不可访问 - 本地 Maven 仓库路径自定义过（如
~/.m2/settings.xml里改了<localrepository></localrepository>），但 VSCode 没被告知
实操建议：
- 右键点击
pom.xml→ 选Reload project（不是刷新文件） - 检查 VSCode 底部状态栏是否显示
Maven字样；若只显示Java 17，说明 Maven 未被识别 - 在终端运行
mvn dependency:resolve -Dsilent，确认命令行能成功下载依赖 - 若用自定义
.m2路径，在设置中加"java.configuration.updateBuildConfiguration": "interactive"并重载
Java 运行时指向了 JRE 而非 JDK
java.home 必须指向 JDK 安装根目录（含 bin/javac），不能是 JRE（只有 bin/java）。Spring Boot 3.x 要求 JDK 17+，用 JDK 8 或仅 JRE 会导致语言服务器启动失败，自动导入彻底静默。
实操建议：
- 按
Ctrl+Shift+P→ 输入Java: Configure Java Runtime→ 点击Add Runtime - 选择你本地的 JDK 17+ 根目录（如
/usr/lib/jvm/jdk-17.0.2或C:\Program Files\Java\jdk-17.0.2） - 确认设置后，VSCode 右下角应显示类似
Java 17 (Maven)的完整标识
最常被忽略的一点：自动导入不是“写完再补”，而是在补全过程中实时触发。如果光标停在 ArrayL 上按 Tab 或回车，它才可能插入 import java.util.ArrayList;；单纯敲完再 Ctrl+Save 是没用的。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
