VS Code配置Java环境全过程

一、核心配置项（必装 / 必配）

基础环境：JDK（Java Development Kit）

这是运行 Java 的核心，VSCode 本身不包含 JDK，必须先安装并配置环境变量。

步骤 1：下载 JDK推荐安装 LTS（长期支持）版本（如 JDK 11、17），可选：

• 官方 Oracle JDK（需登录）：https://www.oracle.com/java/technologies/downloads/
• 免费开源的 Eclipse Temurin（推荐）：https://adoptium.net/

步骤 2：配置环境变量

Windows：

• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」；
• 新建「系统变量」：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

执行source ~/.zshrc生效，输入java -version验证。

VSCode 插件（核心 + 可选）

VSCode 本身不支持 Java，需安装插件扩展能力，优先装官方包：

插件名称 作用 是否必装

• Extension Pack for Java 微软官方 Java 扩展包（包含语法高亮、调试、运行、代码补全等核心功能） ✅ 必装
• Maven for Java 支持 Maven 项目（识别 pom.xml、下载依赖、运行 Maven 命令） 按需（Maven 项目必装）
• Gradle for Java 支持 Gradle 项目（识别 build.gradle、管理依赖） 按需（Gradle 项目必装）
• Project Manager for Java 更方便地管理 Java 项目结构 可选

安装方法：

• 打开 VSCode → 点击左侧「扩展」图标（快捷键Ctrl+Shift+X）→ 搜索插件名称 → 点击「安装」。

VSCode 的 Java 路径配置（可选，自动识别失败时用）

• 如果 VSCode 没自动识别到 JDK，需手动指定：
• 打开 VSCode 设置（快捷键Ctrl+,/Cmd+,）；
• 搜索java.home，点击「在 settings.json 中编辑」；
• 添加 JDK 路径（注意路径转义，Windows 用\，Mac/Linux 用/）：

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

二、运行 Java 项目的不同场景

场景 1：单个 Java 文件（无项目结构）

• 直接在 VSCode 中打开.java文件（如HelloWorld.java）；
• VSCode 会自动检测并加载 Java 环境，等待右下角提示「Java 项目加载完成」；

运行方式：

• 右键文件空白处 → 选择「Run Java」；
• 点击代码右上角的「运行」图标；
• 使用快捷键Ctrl+Alt+N（需确保插件已激活）。

场景 2：Maven/Gradle 项目（有 pom.xml/build.gradle）

• 打开项目根目录（关键！VSCode 需将项目根目录作为工作区）：
• 点击「文件」→「打开文件夹」→ 选择包含pom.xml/build.gradle的文件夹；
• 等待插件自动下载依赖（右下角会显示进度，首次可能较慢）；

运行方式：

• 找到包含main方法的类，右键 →「Run Java」；
• 对于 Maven 项目：打开「终端」→ 执行mvn clean compile exec:java（需配置 pom.xml 的 mainClass）。

三、常见优化（可选）

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>

四、总结

• 核心前提：安装 JDK 并配置JAVA_HOME环境变量，通过java -version验证有效性；
• 关键插件：必装「Extension Pack for Java」，Maven/Gradle 项目按需装对应插件；
• 运行规则：单个文件直接打开运行，项目文件需打开根目录，等待依赖加载完成后再运行。

我的笔记：

运行后打开了这里

在这里配置正确

以上为个人经验，希望能给大家一个参考，也希望大家多多支持脚本之家。