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

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

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

一、核心配置項(xiàng)（必裝 / 必配）

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

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

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

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

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

Windows：

右鍵「此電腦」→「屬性」→「高級(jí)系統(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；
驗(yàn)證：打開 CMD，輸入java -version和javac -version，能顯示版本號(hào)即配置成功。

Mac/Linux：

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

添加兩行：

bash
運(yùn)行

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驗(yàn)證。

VSCode 插件（核心 + 可選）

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

插件名稱作用是否必裝

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

安裝方法：

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

VSCode 的 Java 路徑配置（可選，自動(dòng)識(shí)別失敗時(shí)用）

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

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

二、運(yùn)行 Java 項(xiàng)目的不同場(chǎng)景

場(chǎng)景 1：?jiǎn)蝹€(gè) Java 文件（無項(xiàng)目結(jié)構(gòu)）

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

運(yùn)行方式：

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

場(chǎng)景 2：Maven/Gradle 項(xiàng)目（有 pom.xml/build.gradle）

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

運(yùn)行方式：

找到包含main方法的類，右鍵 →「Run Java」；
對(duì)于 Maven 項(xiàng)目：打開「終端」→ 執(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>

四、總結(jié)

核心前提：安裝 JDK 并配置JAVA_HOME環(huán)境變量，通過java -version驗(yàn)證有效性；
關(guān)鍵插件：必裝「Extension Pack for Java」，Maven/Gradle 項(xiàng)目按需裝對(duì)應(yīng)插件；
運(yùn)行規(guī)則：?jiǎn)蝹€(gè)文件直接打開運(yùn)行，項(xiàng)目文件需打開根目錄，等待依賴加載完成后再運(yùn)行。

我的筆記：