在VSCode配置Java开发环境

0 阅读4分钟

引言:为什么选择VS Code进行Java开发?

目前,Cursor、codebuddy、Trae等主流的AI编程工具都是基于Visual Studio Code(VS Code)的使用习惯开发的,Java开发也应不再局限于EclipseIntelliJ IDEA

AI 编程工具的主要形态

目前市面上的AI编程工具,大致分为三种类型:

1. AI IDE 集成开发环境

  • Cursor:当前 AI 编程领域估值遥遥领先
  • Windsurf:已被 OpenAI 收购
  • codebuddy 腾讯开发
  • Trae:字节跳动开发

2. AI IDE 插件

  • 阿里通义灵码
  • codebuddy

3. AI 命令行工具

  • Claude Code
  • Gemini CLI

一、准备工作

默认电脑已经下载安装了jdk、git、maven、VS Code等工具。

若没有安装,可以参考:Java环境配置之各类组件下载安装教程整理(jdk、idea、git、maven、mysql、redis)

二、安装各类插件

VS Code通过插件扩展Java开发能力,点击左侧的"扩展"按钮或按Ctrl+Shift+X,搜索相关插件进行安装

1. Extension Pack for Java(微软官方 Java 插件包)

这是最推荐的起点!一键安装,包含以下 6 个核心插件:

  • Language Support for Java by Red Hat
    → 提供智能代码补全、语法高亮、错误诊断、重构(重命名、提取方法等)
  • Debugger for Java
    → 支持断点调试、变量监视、调用栈查看
  • Test Runner for Java
    → 可视化运行 JUnit / TestNG 单元测试
  • Maven for Java
    → 支持 Maven 项目导入、依赖管理、生命周期命令执行
  • Project Manager for Java
    → 方便在多个 Java 项目间切换
  • Visual Studio IntelliCode
    → AI 增强的智能代码补全(基于上下文预测)

2. Spring Boot Extension Pack(如果你使用 Spring Boot)

包含:

  • Spring Boot Tools:配置文件(application.yml)智能提示、跳转
  • Spring Initializr:快速创建 Spring Boot 项目
  • Spring Boot Dashboard:可视化管理正在运行的 Spring Boot 应用

✅3. GitLens:增强Git功能,显示代码提交历史

✅4. Lombok Annotations Support for VS Code:支持Lombok注解

5.MyBatisX 或者Super Mybatis(MyBatis 专用增强)

✅6.XML Tools

7.YAML(由 Red Hat 官方出品)

8. Chinese (Simplified) (简体中文) Language Pack for Visual Studio Code

9.Todo Tree

10. Material Icon Theme:美化文件图标,提升视觉体验

安装完成后重启VS Code使插件生效

三、VS Code环境配置

1.项目配置文件setting.json

settings.json 文件包含了 VSCode 的所有自定义设置。这些设置可以覆盖默认设置,以满足用户的个性化需求。

VSCode 的设置分为全局设置和项目级设置两种:

全局设置:适用于所有项目,存储在用户目录下的 .vscode/settings.json 文件中。

项目级设置:仅适用于当前项目,存储在项目根目录下的 .vscode/settings.json 文件中。

在vscode打开工作目录后,按下 Ctrl + Shift + P,搜索settings.json

按下打开工作区设置(JSON)后,会在当前项目目录下自动创建一个.vscode 的目录,目录下会有一个 setting.json

参考配置如下:(记得替换为自己本地安装的真实路径)

{
    //1.配置 maven
    "maven.terminal.useJavaHome": true,
    //注意:"java.home" 已被弃用(旧版使用
    "java.jdt.ls.java.home": "F:\software\java\jdk1.8.0_471",
    // 配置 maven命令所在的路径
    "maven.executable.path": "F:\software\maven\apache-maven-3.8.1\bin\mvn",
    // maven配置文件, 若不指定则会使用 maven.executable.path所属Maven的settings.xml
    "maven.settingsFile": "F:\lixiaofei\repository\maven\settings.xml",

    //2.配置JDK,类似于IDEA中配置JDK,可以在Project Settings中选择,用于项目启动
    "java.configuration.runtimes": [
        
        {
            "name": "JavaSE-1.8",
            "path": "F:\software\java\jdk1.8.0_471",
            "default": true
        },
        {
            "name": "JavaSE-17",
            "path": "F:\software\java\jdk-17.0.12",
            "default": false
        },
        {
            "name": "JavaSE-21",
            "path": "F:\software\java\jdk-21.0.10",
            "default": false
        }
    ],
    // 3.配置Git
    "git.path": "F:\software\Git\bin\git.exe",

    // 优化

    //Maven 依赖视图和 Java 包资源管理器均以 分层(树状)结构 展示
    "maven.view": "hierarchical",
    "java.dependency.packagePresentation": "hierarchical",

    "java.debug.settings.onBuildFailureProceed": true,
    "java.debug.settings.hotCodeReplace": "auto",   //debug自动加载修改后的类

    "problems.decorations.enabled": false,        // 关闭行内错误波浪线
    "java.compile.nullAnalysis.mode": "disabled", // 关闭 @Nullable 分析
    "editor.unusedImports.severity": "ignore",    // 忽略未使用 import 警告
    "editor.showUnused": false,                    // 隐藏未使用变量灰色高亮

    "files.autoSave": "afterDelay",             //自动保存:延迟 
    "files.autoSaveDelay": 1000,                  //自动保存延迟时间:1000毫秒  

    // 自动下载源码和文档
    // "java.maven.downloadSources": true,
    // "java.maven.downloadJavadoc": true,

  // 自动更新构建配置(如 pom.xml 修改后)
  "java.configuration.updateBuildConfiguration": "interactive",
}

2.JDK配置

参考官方教程

随着 Java 的发展,开发人员使用多个 JDK 版本是很常见的。您可以通过设置 java.configuration.runtimes 将它们映射到本地安装路径。该设置的格式如下:(注意替换为自己本地安装的JDK的版本和路径)

{
  //2.配置JDK,类似于IDEA中配置JDK,可以在Project Settings中选择,用于项目启动
    "java.configuration.runtimes": [
        
        {
            "name": "JavaSE-1.8",
            "path": "F:\software\java\jdk1.8.0_471",
            "default": true
        },
        {
            "name": "JavaSE-17",
            "path": "F:\software\java\jdk-17.0.12",
            "default": false
        },
        {
            "name": "JavaSE-21",
            "path": "F:\software\java\jdk-21.0.10",
            "default": false
        }
    ],
}

可以通过向条目添加 "default": true 来将其中一个设置为默认值。默认 JDK 将用于您的非受管文件夹(没有构建工具)。

在命令面板(Ctrl+Shift+P)中触发命令 Java: Configure Java Runtime 会打开一个视图,显示项目的运行时信息,可以查看或切换JDK。

3.Maven配置

参考:官方教程或者在 VS Code 中配置 Maven

1.配置maven的配置文件地址

2.配置maven的服务启动文件

3.管理maven依赖

4.Git配置

参考文章:基于 VScode 的 git 详细使用指南

1.配置Git可执行文件路径

2.执行Git操作和管理Git仓库

四、Spring Boot项目开发

参考官方教程

1.创建Spring Boot项目

  1. 打开命令面板

按下Ctrl+Shift+P,输入Spring Initializr: Create a Maven Project

vscode.js.cn/assets/docs…

参考

vscode.js.cn/docs/java/j…

mp.weixin.qq.com/s/IjtFS7BtA…

jishuzhan.net/article/194…