一、前置條件（必須先安裝）

在配置 VSCode 的 Maven 環(huán)境前，需要先安裝好以下工具：

1. JDK（推薦 JDK 8/11/17，Maven 對新版本 JDK 兼容性較好）
2. Maven（官網(wǎng)下載 /apache-maven-3.6 + 版本）
3. 配置環(huán)境變量：

• 配置JAVA_HOME（指向 JDK 安裝目錄）
• 配置MAVEN_HOME（指向 Maven 安裝目錄）
• 把%MAVEN_HOME%\bin和%JAVA_HOME%\bin添加到系統(tǒng)Path中
• 驗證：打開終端執(zhí)行 java -version 和 mvn -v，能正常輸出版本信息即配置成功。

二、VSCode 配置步驟

1. 安裝必備插件

打開 VSCode，在左側(cè)擴展欄（Ctrl+Shift+X）搜索并安裝以下插件：

• Extension Pack for Java（微軟官方 Java 擴展包，包含核心的 Java 開發(fā)工具）
• Maven for Java（專門支持 Maven 項目的插件，提供 pom.xml 編輯、依賴管理、生命周期執(zhí)行等功能）
• 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 可執(zhí)行文件路徑（如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. 創(chuàng)建 / 打開 Maven 項目

方式 1：創(chuàng)建新的 Maven 項目

打開 VSCode 命令面板（Ctrl+Shift+P），輸入 Maven: Create Maven Project，回車。

選擇 Maven Archetype（推薦maven-archetype-quickstart，基礎(chǔ) Java 項目模板）。

選擇 Archetype 版本（直接回車選最新即可）。

輸入項目信息：

• Group Id（如com.example，組織 / 包名前綴）
• Artifact Id（如maven-demo，項目名）
• Version（默認1.0-SNAPSHOT，回車即可）
• Package（默認和 Group Id 一致，回車即可）

選擇項目保存路徑，等待 Maven 自動生成項目結(jié)構(gòu)。

方式 2：打開已有的 Maven 項目

點擊 VSCode 左側(cè)「文件」→「打開文件夾」，選擇 Maven 項目的根目錄（包含 pom.xml 的目錄）。

VSCode 會自動識別 Maven 項目，并加載依賴（首次加載可能需要幾分鐘，耐心等待）。

4. 驗證環(huán)境是否正常

打開項目中的src/main/java/com/example/App.java（自動生成的測試類）。

右鍵點擊文件，選擇「Run Java」，終端會輸出Hello World!，說明運行正常。

驗證 Maven 命令：打開 VSCode 終端（Ctrl+），執(zhí)行 mvn clean package，能成功打包生成target` 目錄，說明 Maven 命令執(zhí)行正常。

三、優(yōu)化配置（可選，提升開發(fā)體驗）

配置 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>

總結(jié)

1. 搭建核心：先安裝并配置 JDK 和 Maven 的環(huán)境變量，再給 VSCode 裝 Java 和 Maven 插件。
2. 關(guān)鍵驗證：通過「創(chuàng)建 Maven 項目 + 運行測試類 + 執(zhí)行 mvn 命令」確認環(huán)境可用。
3. 優(yōu)化點：配置阿里云 Maven 鏡像可大幅提升依賴下載速度，是必做的優(yōu)化項。

整個過程完成后，你就可以在 VSCode 中正常開發(fā)、編譯、打包 Java Maven 項目了。如果遇到依賴加載慢、插件識別失敗等問題，優(yōu)先檢查環(huán)境變量和 VSCode 的 settings.json 配置是否正確。

到此這篇關(guān)于VSCode中搭建JAVA+MAVEN開發(fā)環(huán)境的文章就介紹到這了,更多相關(guān)VSCode搭建JAVA+MAVEN開發(fā)環(huán)境內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論