vs code java 补全异常主因是 extension pack for java、jdk≥17（路径显式配置于java.configuration.runtimes）及 maven/gradle 元数据三者未对齐；需启用语义补全（java.completion.enabled: true）、触发构建解析（点「import changes」），并确认右下角语言模式为 java。
Java 扩展包和 JDK 路径必须对齐
VS Code 的 Java 补全不是靠编辑器本身，而是靠 Extension Pack for Java 启动的 Java Language Server。如果补全不出现、方法名灰掉、@Data 字段没提示，第一件事不是调设置，而是确认三者是否匹配：
- 已安装最新版
Extension Pack for Java（含Language Support for Java） - JDK 版本 ≥ 17（推荐 JDK 17 或 21 LTS），且路径在 VS Code 设置中显式声明：
"java.configuration.runtimes": [{ "name": "JavaSE-17", "path": "/opt/java/jdk-17.0.2" }] - 项目根目录有
pom.xml或build.gradle，且语法无硬错误（比如<dependency></dependency>标签闭合缺失）
路径写错或 JDK 版本太低，语言服务器压根起不来——这时候调任何 java.suggest.* 都是白忙。
启用语义补全而非纯文本补全
默认情况下，VS Code 可能只做简单关键字匹配（比如输入 Str 提示 String），但不会推导泛型类型、不会显示 Stream.map() 的参数类型。要激活真正“智能”的补全，必须开启语义分析：
- 确保
"java.completion.enabled": true（不是editor.quickSuggestions） - 打开参数猜测：
"java.completion.guessMethodArguments": true - 导入顺序影响补全优先级：
"java.completion.importOrder": ["java", "javax", "com", "org"] - 延迟设太低（如
50）反而卡顿，建议"editor.quickSuggestionsDelay": 200
注意：editor.quickSuggestions 控制的是“是否弹框”，而 java.completion.enabled 才决定“弹出来的是不是语义结果”。两者都开，才完整。
Lombok / Spring 注解字段不提示？得手动触发构建解析
@Getter、@Autowired 字段没补全，大概率不是插件问题，而是语言服务器没加载注解处理器生成的桥接类。VS Code 不会自动监听 pom.xml 变更并重载 classpath：
- 在项目根目录建
.vscode/settings.json，加这行："java.configuration.updateBuildConfiguration": "interactive" - 保存后右下角弹出「Import Changes」按钮，**必须点它**，否则配置不生效
- Lombok 项目额外加：
"java.compile.nullAnalysis.mode": "automatic"和"java.configuration.checkProjectSettings": true
不点「Import Changes」，改一百遍 settings.json 都没用——这是最常被跳过的一步。
补全触发不了？检查触发字符和语言模式
输入 list. 没反应，可能根本没进入 Java 语言上下文：
- 确认右下角状态栏显示的是
Java，不是Plain Text或Unknown；点它可手动切换 -
editor.suggestOnTriggerCharacters必须为true（默认是 true，但某些主题插件会覆盖） - Java 场景下关键触发字符是
.、、<code>(，不是=或;；别指望输入private String n就弹name - 如果用了 Kite 或 Tabnine 这类 AI 补全插件，关掉它们再试——它们有时劫持
.行为，导致语言服务器建议被压制
补全失效时，先按 Ctrl+Space 手动唤出建议框，看有没有内容。没有，说明语言服务器没工作；有但不对，才是配置或语义问题。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
