Java语言服务器与Maven构建

Java语言服务器与Maven构建 | AI生成和翻译

Home 2025.02

看起来你在 Visual Studio Code (VSCode) 中遇到了两个相关问题：一是提示需要至少 Java 21，二是 VSCode 无法识别代码中的某些对象定义，尽管你的 Maven 构建可以成功编译。让我们逐步解决这个问题。

问题的根源在于 VSCode 的 Java 扩展（特别是 Java 语言服务器）与你的 Maven 构建在 Java 开发工具包 (JDK) 版本或项目配置上可能不一致。VSCode 提示需要 JDK 21 才能正常运行，而解析错误表明它没有以与 Maven 相同的方式解释你的代码。以下是修复方法：

步骤 1：安装 JDK 21

由于 VSCode 明确要求 Java 21，你需要确保系统中已安装该版本。

下载 JDK 21：从可信来源获取，例如 Oracle 官网或 Adoptium。
安装：按照安装说明操作，并记下安装路径（例如，Windows 上是 C:\Program Files\Java\jdk-21，Linux 上是 /usr/lib/jvm/java-21-openjdk）。
验证：打开终端并运行 java -version。你应该看到类似以下内容：
```
java version "21.0.1" ...
```

步骤 2：配置 VSCode 使用 JDK 21

你需要告诉 VSCode 的 Java 扩展使用 JDK 21。方法如下：

打开 VSCode 设置：
- 转到 文件 > 首选项 > 设置（或按 Ctrl + ,）。
设置 JDK 路径：
- 搜索 java.jdt.ls.java.home。
- 输入你的 JDK 21 安装路径（例如 C:\Program Files\Java\jdk-21）。
- 可选地，搜索 java.home 并设置为相同路径以保持一致性。
编辑 settings.json（替代方法）：
- 打开命令面板（Ctrl + Shift + P），输入“Preferences: Open Settings (JSON)”，并添加：
```
{
    "java.jdt.ls.java.home": "C:\\Program Files\\Java\\jdk-21",
    "java.home": "C:\\Program Files\\Java\\jdk-21"
}
```
- 根据你的系统调整路径（Linux/Mac 使用正斜杠 /）。

这确保了 VSCode 中的 Java 语言服务器使用 JDK 21，满足最低要求。

步骤 3：在 VSCode 中设置项目的 JDK

要修复解析问题（例如找不到对象定义），请确保你的 VSCode 项目也使用 JDK 21：

在 settings.json 中添加以下内容，为项目指定 JDK 21：

"java.configuration.runtimes": [
    {
        "name": "JavaSE-21",
        "path": "C:\\Program Files\\Java\\jdk-21",
        "default": true
    }
]

这将使 VSCode 的项目运行时与 JDK 21 对齐，从而帮助其正确解析你的代码。

步骤 4：验证 Maven 的 JDK 配置

由于你的 Maven 构建（mvn compile）正常工作，它很可能使用了兼容的 JDK。让我们确认并将其与 VSCode 对齐：

检查 Maven 的 JDK：
- 在终端中运行 mvn -version。查看“Java version”行（例如 Java version: 21.0.1）。
- 如果未使用 JDK 21，请将 JAVA_HOME 环境变量设置为你的 JDK 21 路径：
  - Windows：set JAVA_HOME=C:\Program Files\Java\jdk-21
  - Linux/Mac：export JAVA_HOME=/usr/lib/jvm/java-21-openjdk
- 再次运行 mvn -version 以确认。

在 pom.xml 中指定 JDK（可选）：

如果要在 Maven 项目中强制使用 JDK 21，请在 pom.xml 中添加以下内容：

<properties>
    <maven.compiler.source>21</maven.compiler.source>
    <maven.compiler.target>21</maven.compiler.target>
</properties>

步骤 5：刷新 VSCode

完成上述更改后，需要刷新 VSCode 以应用它们：

重新加载 VSCode：
- 打开命令面板（Ctrl + Shift + P），选择“Developer: Reload Window”。
或者，关闭并重新打开 VSCode。

步骤 6：确保依赖项已加载

如果 VSCode 仍然找不到对象定义，可能是未正确加载 Maven 依赖项：

清理工作区：
- 打开命令面板（Ctrl + Shift + P）。
- 运行“Java: Clean Java Language Server Workspace”。
强制编译：
- 在命令面板中运行“Java: Force Java Compilation”。
检查导入：
- 确保项目的 Maven 依赖项已导入，方法是右键单击 VSCode 中的 pom.xml 并选择“Update Project Configuration”。

故障排除

如果问题仍然存在：

检查日志：
- 在 settings.json 中添加 "java.trace.server": "verbose"。
- 打开输出面板（Ctrl + Shift + U）并选择“Java Language Server”以查看详细日志。
验证代码：
- 仔细检查缺失的对象定义是否来自你的代码或 pom.xml 中列出的依赖项，而不是外部问题。

总结

通过安装 JDK 21、配置 VSCode 使用它、对齐项目和 Maven 设置并刷新环境，VSCode 应停止关于 Java 21 的抱怨，并正确解析你的代码，与 Maven 的成功编译保持一致。如果遇到任何问题，请随时告知！

Back Donate