环境准备

1.JDK安装

官网地址: Oracle JDK下载页(注意:选Windows x64 Installer版本就行,社区版推荐用OpenJDK)

默认在windows安装后会配置环境变量,不过为了方便还需要在windows中配置如下环境变量

vscode搭建java开发环境_java

安装完成后,必须检查环境变量
Win+R输入cmd打开终端,输入:

java -version
  • 1.

输出:

java version "1.8.0_66"
Java(TM) SE Runtime Environment (build 1.8.0_66-b18)
Java HotSpot(TM) 64-Bit Server VM (build 25.66-b18, mixed mode)
  • 1.
  • 2.
  • 3.

vscode搭建java开发环境_maven_02

如果提示"不是内部命令",记得去系统环境变量Path里添加JDK的bin目录路径

2.VS Code 安装(超简单)

直接官网下载速度慢?试试国内镜像站!

推荐清华镜像源: https://mirrors.tuna.tsinghua.edu.cn/

安装过程记得勾选这两个选项

✅ 添加到PATH环境变量

✅ 创建桌面快捷方式

3. 必装插件全家桶

按下Ctrl+Shift+X打开扩展商店,搜索安装:

  • Java Extension Pack(核心套装,包含代码提示/调试等功能)
  • Language Support for Java™(智能代码补全)
  • Debugger for Java(调试神器)
  • Maven for Java(项目管理必备)
  • Spring Boot Extension Pack(搞微服务必装)

 装完插件记得重启VS Code才能生效!

或者安装如下插件

“Language Support for Java(TM) by Red Hat”插件即可

vscode搭建java开发环境_java_03

安装此插件后,会自动安装包含如下插件,不再需要单独安装

  • Project Manager for Java
  • Test Runner for Java
  • Debugger for Java
  • Extension Pack for Java
  • Lombok Annotations Support for VS Code

如果你的项目还在使用JDK1.8的话,一定要保证此插件安装的版本为1.35.1以下,并就爱那个自动更新的选项去掉。

4.配置java环境

4.1全局开发环境

vscode搭建java开发环境_java_04

下面是一个设置好 java 开发环境的 setting.json 文件,可以参考着去配置

{
    "editor.fontSize": 16,    // 文本编辑器的字体大小,可以将整改 editor.fontSize 放在设置那里搜索
    "liveServer.settings.donotVerifyTags": true,       // liveServer插件的设置,跟java无关
    "liveServer.settings.donotShowInfoMsg": true,  // liveServer插件的设置,跟java无关
    "explorer.confirmDelete": false,                       // 删除文件时,是否提示放入回收站
    "explorer.confirmDragAndDrop": false,            // 拖移文件时,是否提示确认
    "security.workspace.trust.untrustedFiles": "open",// 受信任工作区那个提示,可以将整个 security.workspace.trust.untrustedFiles 放在设置那里搜索
    "liveServer.settings.CustomBrowser": "chrome",  // liveServer插件的设置,跟java无关
    "javascript.updateImportsOnFileMove.enabled": "always", //跟java无关
    "emmet.triggerExpansionOnTab": true,                 //跟java无关
    "redhat.telemetry.enabled": true,                         // 跟java有关,启用将使用数据和错误发送到Red Hat服务器。请阅读我们的隐私声明。

    // Maven的相关配置信息
    "java.configuration.maven.globalSettings": "D:\maven\apache-maven-3.6.3\conf\settings.xml",   // maven 全局 settings 文件
    "java.maven.downloadSources": true,              //让maven下载源码
    "java.configuration.maven.userSettings": "",     // 配置 maven settings 文件,配置了全局 settings 文件在这里就可以不用写了。
    "maven.executable.path": "D:\maven\apache-maven-3.6.3\bin\mvn.cmd",    //指定mvn可执行文件的绝对路径。当此值为空时,它会根据maven.executable.preferMavenwrapper的值尝试使用mvn或mvnw
    "maven.settingsFile": "D:\maven\apache-maven-3.6.3\conf\settings.xml", // 指定 maven 配置文件的绝对路径,默认是 ~/.m2/settings.xml。配上也行,不配好像也没有什么影响
    "maven.executable.options": "-DarchetypeCatalog=internal",   // 指定所有mvn命令的默认选项。

    // Java相关配置信息,配置使用的JDK如果安装了多个JDK可以在这个数组上多配一个,但是记得默认用哪个就需要加上"default": true,电脑只是安装了一个JDK这个可以不用配置。
    "java.configuration.runtimes": [
        {
          "name": "JavaSE-1.8",
          "path": "C:\Program Files\Java\jdk1.8.0_181",
          "default": true
        }
      ],
      "rsp-ui.enableStartServerOnActivation": [ // 跟 Community Server 插件有关的配置吧,应该是跟java有关系的。但是不要乱配置,认识这个配置后在配置
        {
          "id": "redhat.vscode-community-server-connector",
          "name": "Community Server Connector",
          "startOnActivation": true
        }
      ],
      "java.jdt.ls.java.home": "c:\Program Files\Java\jdk1.8.0_181",   //配一下jdk路径,有一些不同版本的插件又不叫 java.jdt.ls.java.home,注意甄别。
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
  • 6.
  • 7.
  • 8.
  • 9.
  • 10.
  • 11.
  • 12.
  • 13.
  • 14.
  • 15.
  • 16.
  • 17.
  • 18.
  • 19.
  • 20.
  • 21.
  • 22.
  • 23.
  • 24.
  • 25.
  • 26.
  • 27.
  • 28.
  • 29.
  • 30.
  • 31.
  • 32.
  • 33.
  • 34.
  • 35.
  • 36.
  • 37.

不同的插件有不同配置项,可以参照插件说明进行配置

4.2Runtime JDK配置

实际开发中,电脑中安装了不同版本的JDK,以适应不同的项目,VSCode并不会像IDEA那样可以直接设置项目的JDK版本,

VSCode需要我们自己手动配置,具体步骤如下:

步骤1:创建工作区

新建文件夹(比如java_demo),在VS Code中打开这个文件夹

步骤2:创建第一个Java文件

右键资源管理器 → 新建文件 → 命名为HelloWorld.java

输入经典代码:

public class HelloWorld {
    public static void main(String[] args) {
        System.out.println("Hello, VS Code!");
    }
}
  • 1.
  • 2.
  • 3.
  • 4.
  • 5.
步骤3:配置

vscode搭建java开发环境_Java_05

步骤4:一键运行调试

在代码编辑区右键→ 选择"Run Java"

5.创建项目

设置→命令面板→输入java

vscode搭建java开发环境_Java_06

选择创建Java项目

vscode搭建java开发环境_java_07

根据具体情况及安装的插件可以创建普通的java项目、基于maven创建java项目、基于maven的javaweb以及spring boot项目

6.常见问题.

❌ 问题1: 出现‘boolean org.eclipse.jdt.internal.core.SourceMethod.isMainMethodCandidate()‘错误

错误来源:Debugger for Java

分析原因

类路径或依赖问题:org.eclipse.jdt.internal.core.SourceMethod 类属于 Eclipse JDT 内部实现的一部分,通常这些内部类和方法不应该被直接调用。如果在项目中使用了这些内部类或方法,而未正确配置依赖项或者 Eclipse 环境没有正确设置,可能会导致找不到类或方法的错误。 Eclipse 版本不兼容:如果你使用的 Eclipse 版本与代码中引用的 JDT 版本不兼容,可能会导致一些内部方法无法正确识别或调用。

解决方法

通过降低Debugger for Java版本来实现 我这里是从0.58.0降低到0.56.2,重新启用拓展就解决的了  

❌ 问题2:编码错误

中文乱码?在settings.json里添加:

"files.encoding": "gbk",
"java.jdt.ls.vmargs": "-Dfile.encoding=gbk"
  • 1.
  • 2.
❌ 问题3:找不到主类
  1. 类名是否与文件名一致
  2. 是否在正确的package路径下
  3. launch.json中的mainClass是否带包名(如com.example.App)
❌ 问题4:无法识别System.out.println

Ctrl+Shift+P执行Java: Clean Java Language Server Workspace,重启VS Code