VSCode中搭建JAVA+MAVEN开发环境的完整步骤

一、前置条件（必须先安装）

在配置 VSCode 的 Maven 环境前，需要先安装好以下工具：

1. JDK（推荐 JDK 8/11/17，Maven 对新版本 JDK 兼容性较好）
2. Maven（官网下载 /apache-maven-3.6 + 版本）
3. 配置环境变量：

• 配置JAVA_HOME（指向 JDK 安装目录）
• 配置MAVEN_HOME（指向 Maven 安装目录）
• 把%MAVEN_HOME%\bin和%JAVA_HOME%\bin添加到系统Path中
• 验证：打开终端执行 java -version 和 mvn -v，能正常输出版本信息即配置成功。

二、VSCode 配置步骤

1. 安装必备插件

打开 VSCode，在左侧扩展栏（Ctrl+Shift+X）搜索并安装以下插件：

• Extension Pack for Java（微软官方 Java 扩展包，包含核心的 Java 开发工具）
• Maven for Java（专门支持 Maven 项目的插件，提供 pom.xml 编辑、依赖管理、生命周期执行等功能）
• Project Manager for Java（可选，方便管理多个 Java/Maven 项目）

2. 配置 VSCode 的 Java/Maven 路径（可选，自动识别失败时手动配置）

如果 VSCode 没有自动识别 JDK/Maven 路径，需要手动配置：

打开 VSCode 设置（Ctrl+,），搜索 java.configuration.runtimes，点击「编辑 in settings.json」。

添加 JDK 配置（示例为 JDK 11）：

"java.configuration.runtimes": [
    {
        "name": "JavaSE-11",
        "path": "你的JDK安装路径（如D:\\jdk-11.0.19）",
        "default": true
    }
]

搜索 maven.executable.path，设置 Maven 可执行文件路径（如D:\\apache-maven-3.9.6\\bin\\mvn.cmd）。

搜索 maven.settings.file，可选配置 Maven 的 settings.xml 路径（如D:\\apache-maven-3.9.6\\conf\\settings.xml，用于配置镜像、本地仓库等）。

3. 创建 / 打开 Maven 项目

方式 1：创建新的 Maven 项目

打开 VSCode 命令面板（Ctrl+Shift+P），输入 Maven: Create Maven Project，回车。

选择 Maven Archetype（推荐maven-archetype-quickstart，基础 Java 项目模板）。

选择 Archetype 版本（直接回车选最新即可）。

输入项目信息：

• Group Id（如com.example，组织 / 包名前缀）
• Artifact Id（如maven-demo，项目名）
• Version（默认1.0-SNAPSHOT，回车即可）
• Package（默认和 Group Id 一致，回车即可）

选择项目保存路径，等待 Maven 自动生成项目结构。

方式 2：打开已有的 Maven 项目

点击 VSCode 左侧「文件」→「打开文件夹」，选择 Maven 项目的根目录（包含 pom.xml 的目录）。

VSCode 会自动识别 Maven 项目，并加载依赖（首次加载可能需要几分钟，耐心等待）。

4. 验证环境是否正常

打开项目中的src/main/java/com/example/App.java（自动生成的测试类）。

右键点击文件，选择「Run Java」，终端会输出Hello World!，说明运行正常。

验证 Maven 命令：打开 VSCode 终端（Ctrl+），执行 mvn clean package，能成功打包生成target` 目录，说明 Maven 命令执行正常。

三、优化配置（可选，提升开发体验）

配置 Maven 镜像（加速依赖下载）：

编辑 Maven 的settings.xml（路径：MAVEN_HOME/conf/settings.xml），添加阿里云镜像：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <mirrorOf>central</mirrorOf>
        <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
</mirrors>

设置本地仓库路径：

在settings.xml中添加：

<localRepository>你的本地仓库路径（如D:\\maven-repo）</localRepository>

总结

1. 搭建核心：先安装并配置 JDK 和 Maven 的环境变量，再给 VSCode 装 Java 和 Maven 插件。
2. 关键验证：通过「创建 Maven 项目 + 运行测试类 + 执行 mvn 命令」确认环境可用。
3. 优化点：配置阿里云 Maven 镜像可大幅提升依赖下载速度，是必做的优化项。

整个过程完成后，你就可以在 VSCode 中正常开发、编译、打包 Java Maven 项目了。如果遇到依赖加载慢、插件识别失败等问题，优先检查环境变量和 VSCode 的 settings.json 配置是否正确。

到此这篇关于VSCode中搭建JAVA+MAVEN开发环境的文章就介绍到这了,更多相关VSCode搭建JAVA+MAVEN开发环境内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！