在 VS Code 中配置 Java 开发环境

发表于 更新于 阅读次数：

插件安装

首先安装几个必备的插件。

  1. Extension Pack for Java
  2. Spring Boot Extension Pack

环境配置

基础配置

设置 id 描述 示例值
java.jdt.ls.java.home 指定用于启动 Java 语言服务器的 JDK（21 或更高版本）的文件夹路径。此设置将替换 Java 扩展内置的 JRE 以启动 Java 语言服务器。 D:\Java\25
java.configuration.maven.userSettings maven 用户 settings.xml 文件的路径。 D:\maven3\conf\settings.xml
java.configuration.maven.globalSettings maven 全局 settings.xml 文件的路径。 D:\maven3\conf\settings.xml
maven.settingsFile 指定 maven 配置文件的绝对路径。 D:\maven3\conf\settings.xml
maven.executable.path 指定 mvn 可执行文件的绝对路径。 D:\maven3\bin\mvn
maven.terminal.useJavaHome 如果此值为 true ，并且配置项 java.home 具有值，则在创建新的终端窗口时，将环境变量 JAVA_HOME 设置为 java.home 的值。 true
java.maven.downloadSources 启用/禁用在导入 Maven 项目时下载依赖源码。 true

配置不同版本的 JDK

"java.configuration.runtimes": [
    {
        "name": "JavaSE-1.8",
        "path": "D:\\Java\\8",
        "default": true
    },
    {
        "name": "JavaSE-25",
        "path": "D:\\Java\\25",
    },
],

完整配置示例：

{
    "java.jdt.ls.java.home": "D:\\Java\\25",
    "java.configuration.maven.userSettings": "D:\\maven3\\conf\\settings.xml",
    "java.configuration.maven.globalSettings": "D:\\maven3\\conf\\settings.xml",
    "maven.settingsFile": "D:\\maven3\\conf\\settings.xml",
    "maven.executable.path": "D:\\maven3\\bin\\mvn",
    "maven.terminal.useJavaHome": true,
    "java.maven.downloadSources": true,
    "java.completion.matchCase": "off",
    "java.configuration.runtimes": [
        {
            "name": "JavaSE-1.8",
            "path": "D:\\Java\\8",
            "default": true
        },
        {
            "name": "JavaSE-25",
            "path": "D:\\Java\\25",
        },
    ],
}

配置不生效的解决方法

有时候 VS Code 显示没生效，其实只是缓存没刷新。

  1. 查看有效配置：打开 VS Code 内置终端，输入：
mvn help:effective-settings

观察输出结果中的 localRepository 指向哪里。如果这里是对的，说明 Maven 已经识别了，只是 VS Code 插件还没反应过来。

  1. 清理 Java 语言服务器状态：
    • 按 Ctrl + Shift + P。
    • 输入并选择：Java: Clean Java Language Server Workspace。
    • 选择 Reload and delete。这会强制插件重新读取所有 Maven 配置。

开发体验配置

通过命令安装依赖

mvn dependency:resolve -U

提示忽略大小写

vscode://settings/java.completion.matchCase