一、核心配置项(必装 / 必配)

  1. 基础环境: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:JAVAHOME/bin:PATH
    执行source ~/.zshrc生效,输入java -version验证。
  2. 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)→ 搜索插件名称 → 点击「安装」。
  3. 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 项目按需装对应插件;
运行规则:单个文件直接打开运行,项目文件需打开根目录,等待依赖加载完成后再运行。

我的笔记:

在这里插入图片描述
运行后打开了这里
在这里插入图片描述
在这里配置正确

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐