VS Code配置Java環(huán)境全過程

更新時間：2026年02月04日 09:33:27 作者：灰色人生qwer

文章介紹了如何在VSCode中配置和運行Java項目,包括安裝JDK、配置環(huán)境變量、安裝VSCode插件、處理不同場景的Java項目運行以及常見優(yōu)化方法

一、核心配置項（必裝 / 必配）

基礎(chǔ)環(huán)境：JDK（Java Development Kit）

這是運行 Java 的核心，VSCode 本身不包含 JDK，必須先安裝并配置環(huán)境變量。

步驟 1：下載 JDK推薦安裝 LTS（長期支持）版本（如 JDK 11、17），可選：

官方 Oracle JDK（需登錄）：https://www.oracle.com/java/technologies/downloads/
免費開源的 Eclipse Temurin（推薦）：https://adoptium.net/

步驟 2：配置環(huán)境變量

Windows：

右鍵「此電腦」→「屬性」→「高級系統(tǒng)設(shè)置」→「環(huán)境變量」；
新建「系統(tǒng)變量」：JAVA_HOME，值為 JDK 安裝路徑（如C:\Program Files\Eclipse Adoptium\jdk-17.0.9.9-hotspot）；
編輯「Path」變量，添加%JAVA_HOME%\bin；
驗證：打開 CMD，輸入java -version和javac -version，能顯示版本號即配置成功。

Mac/Linux：

打開終端，編輯配置文件（如_/.zshrc或/.bash_profile）；

添加兩行：

bash
運行

export JAVA_HOME=/Library/Java/JavaVirtualMachines/temurin-17.jdk/Contents/Home
export PATH=JAVAHOME/bin:JAVA_HOME/bin:JAVAH?OME/bin:PATH

執(zhí)行source ~/.zshrc生效，輸入java -version驗證。

VSCode 插件（核心 + 可選）

VSCode 本身不支持 Java，需安裝插件擴(kuò)展能力，優(yōu)先裝官方包：

插件名稱作用是否必裝

Extension Pack for Java 微軟官方 Java 擴(kuò)展包（包含語法高亮、調(diào)試、運行、代碼補(bǔ)全等核心功能） ? 必裝
Maven for Java 支持 Maven 項目（識別 pom.xml、下載依賴、運行 Maven 命令）按需（Maven 項目必裝）
Gradle for Java 支持 Gradle 項目（識別 build.gradle、管理依賴）按需（Gradle 項目必裝）
Project Manager for Java 更方便地管理 Java 項目結(jié)構(gòu) 可選

安裝方法：

打開 VSCode → 點擊左側(cè)「擴(kuò)展」圖標(biāo)（快捷鍵Ctrl+Shift+X）→ 搜索插件名稱 → 點擊「安裝」。

VSCode 的 Java 路徑配置（可選，自動識別失敗時用）

如果 VSCode 沒自動識別到 JDK，需手動指定：
打開 VSCode 設(shè)置（快捷鍵Ctrl+,/Cmd+,）；
搜索java.home，點擊「在 settings.json 中編輯」；
添加 JDK 路徑（注意路徑轉(zhuǎn)義，Windows 用\，Mac/Linux 用/）：

{
  "java.home": "C:\\Program Files\\Eclipse Adoptium\\jdk-17.0.9.9-hotspot"
}

二、運行 Java 項目的不同場景

場景 1：單個 Java 文件（無項目結(jié)構(gòu)）

直接在 VSCode 中打開.java文件（如HelloWorld.java）；
VSCode 會自動檢測并加載 Java 環(huán)境，等待右下角提示「Java 項目加載完成」；

運行方式：

右鍵文件空白處 → 選擇「Run Java」；
點擊代碼右上角的「運行」圖標(biāo)；
使用快捷鍵Ctrl+Alt+N（需確保插件已激活）。

場景 2：Maven/Gradle 項目（有 pom.xml/build.gradle）

打開項目根目錄（關(guān)鍵！VSCode 需將項目根目錄作為工作區(qū)）：
點擊「文件」→「打開文件夾」→ 選擇包含pom.xml/build.gradle的文件夾；
等待插件自動下載依賴（右下角會顯示進(jìn)度，首次可能較慢）；

運行方式：

找到包含main方法的類，右鍵 →「Run Java」；
對于 Maven 項目：打開「終端」→ 執(zhí)行mvn clean compile exec:java（需配置 pom.xml 的 mainClass）。

三、常見優(yōu)化（可選）

Maven 依賴下載慢：配置阿里云鏡像，修改 Maven 的settings.xml（路徑：~/.m2/settings.xml）：

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