JAVA新实战1：使用vscode+gradle+openJDK21搭建java springboot3项目开发环境

对号东

已于 2023-11-05 13:03:06 修改

阅读量8.8k JAVA新实战-经验分享文章标签： java vscode spring boot gradle jdk

于 2023-11-05 12:28:12 首次发布

本文链接：https://blog.csdn.net/duihao/article/details/134226861

JAVA新实战-经验分享专栏收录该内容

5 篇文章 2 订阅

前言

作为一个干了多年的全栈技术工程师，厌倦了使用盗版IDE，近些年开发Java一直使用IntelliJ IDEA进行Springboot后端项目开发，对于IntelliJ IDEA 授权问题，一直花钱买学生类的授权，但经常被屏蔽，无法使用，又不舍得花大钱买企业版，索性不再使用了。决定改用 VsCode+Gradle+OpenJDK21进行JAVA Spring Boot项目开发，后续逐渐前后端都统一一套IDE工具。

一直以来JAVA项目都使用jdk1.8，这次也打算基于最新的openJdk21开启新项目框架搭建，同时尝试从maven转向gradle构建工具，开发工具也尝试使用vscode。并把日常使用的小功能形成一个 jo-java对外仓，把各种代码块传入其中，方便自己，也分享给有需要的朋友。

前缀废话有点多，可略过，看下面的正题。

1、下载安装 vscode

我的电脑安装的是Visual Studio Code 1.83.1 system setup版。

若您未曾安装，请到官网下载安装： Visual Studio Code - Code Editing. RedefinedVisual Studio Code is a code editor redefined and optimized for building and debugging modern web and cloud applications. Visual Studio Code is free and available on your favorite platform - Linux, macOS, and Windows.https://code.visualstudio.com/

2、下载安装 jdk（OpenJDK21）

请进入OpenJDK官方网站下载：OpenJDK JDK 21.0.1 GA Releasehttps://jdk.java.net/21/

下载后解压到指定目录，如：D:\JAVA\jdk21

设置JAVA环境变量：

#系统变量新增
JAVA_HOME
D:\JAVA\jdk21

CLASSPATH
.%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar

#系统变量PATH中增加
,%JAVA_HOME%\bin

打开命令窗口CMD，输入：java -version 显示以下结果表示jdk安装、配置成功。

注意：如果之前有安装过其他版本jdk，需要清理java运行的缓存，重启后系统才能正常。一般在 C:\ProgramData\Oracle\Java 目录下清理。

3、下载安装 gradle（gradle 8.4）

请进入gradle官方网站下载：

Gradle | ReleasesFind binaries and reference documentation for current and past versions of Gradle.https://gradle.org/releases/

下载后解压到：D:\gradle\gradle-8.4

设置gradle环境变量：

# Gradle Home 环境变量

GRADLE_HOME

D:\gradle\gradle-8.4

# Gradle 仓库位置 环境变量

GRADLE_USER_HOME

D:\gradle\repositorys

#Path 中 增加

%GRADLE_HOME%\bin

设置方式和结果如下：

4、VSCode中依次安装所需要的插件

4.1 所需VSCode插件
Gradle for Java
Gradle Language Support
Extension Pack for Java
Project Manager for Java
Spring Boot Extension Pack
Prettier - Code formatter(代码格式化插件不需要可以不安装)

4.2 VSCode插件安装方式

在VSCode中点击左侧栏“插件”图标，搜索要安装的插件，如：“Gradle for Java”，点击Install执行安装。

5、新开发环境测试

5.1 创建一个SpringBoot项目

依次按以下步骤在VSCode中创建基于Gradle的Java SpringBoot项目：

快捷键：Ctrl + Shift + P 输入：gradle 如下图选择跟我一样的蓝色条目选项：Create a Gradle Project

选择 Springboot 版本：我这里选择3.1.5版

输入项目包组名 Group Id：我这里输入 com.duihao

输入包名：我这里输入 jojava

选择构建包类型：一般选择 jar

选择项目引用的JAVA组件：这里我选Spring Web、Lombok、Spring Boot DevTools等

至此，一个SpringBoot项目在VSCode中gradle模式下创建成功，如下图：

5.2 项目开发配置调优

在 build.gradle 文件中增加国内 maven 仓库地址，优化组件加载速度。

常用国内maven仓库地址：

//阿里

maven { url 'https://maven.aliyun.com/nexus/content/groups/public/' }

//腾讯

maven { url 'https://mirrors.cloud.tencent.com/nexus/repository/maven-public/' }

//华为

maven { url 'https://developer.huawei.com/repo/' }

在 .vscode 目录中创建 settings.json 文件并增加以下配置，避免多jdk、gradle版本冲突。

完成后关闭vscode重新打开项目。如果.gradle目录中已经有很多文件，将这里的文件全部删除，再重新打开vscode，这时会根据刚才配置的重新创建。

将Spring Boot项目配置文件类型改为yml格式，默认创建的 Spring Boot 项目配置文件类型为.properties格式，建议进行修改。

在项目资源目录下找到 src/resources/application.propertices 进行修改即可。

5.3 VScode下SpringBoot项目构建

方法一：使用Gradle命令打包构建工程：

# 直接进行打包

gradle build

# 删除build及已经构建完的文件，然后再打包。我常用这个。可以打包jar，也可以打包war 

gradle clean build

方法二：使用VSCode可视化操作执行Gradle构建：

点击左侧菜单栏Gradle小图标，在项目目录下展开Tasks/build，（1）点击 build执行打包，为增量模式，（2）点击clean执行清理，然后点击build全新打包。每次修改项目配置后都需要重新build才能生效。

5.4 VSCode下SpringBoot项目运行

方法一：使用Gradle的bootRun插件可视化操作：

点击左侧菜单栏 Gradle 小图标，在项目目录下展开Tasks/application，点击 bootRun执行项目运行。

方法二：使用Spring Boot 控制台插件进行项目运行：

点击左侧菜单栏 Spring Boot Dashboard 小图标，在 APPS 项目右侧点击运行小图标，执行项目运行。

6、解决VSCode+SpringBoot+gradle的运行命令窗口的中文乱码

找了很多种方法终于相互结合解决掉java新版jdk在vscode、gradle、springboot相互造成的中文乱码问题，以下是多个地方对编码UTF-8设置的配置，有些电脑可能设置一处即可，有些可能需要设置多处可用。

6.1 第一处 VSCode setting.json

VSCode setting.json中的设置：通过点击右下角设置图标，点击“Settings”进入设置界面，从

中找到“Edit in setting.json”点击进入setting.json编辑模式。

在setting.json 最后json块加入以下代码


    "terminal.integrated.profiles.windows": {
        "PowerShell": {
            "source": "PowerShell",
            "icon": "terminal-powershell",
            "args": ["-NoExit", "/c", "chcp 65001"]
        },
        "Command Prompt": {
            "path": [
                "${env:windir}\\Sysnative\\cmd.exe",
                "${env:windir}\\System32\\cmd.exe",
            ],
            "args": ["-NoExit", "/c", "chcp 65001"],
            "icon": "terminal-cmd"
        },
        "Git Bash": {
            "source": "Git Bash"
        }
    }

结果如下：

6.2 第二处项目编码配置

在项目资源目录下 src/main/resources找到配置文件 application.yml或application.properties文件，配置 server.servlet.encoding.charset、server.tomcat.uri-encoding 为 UTF-8，两种配置文件格式配置方式有所不同，下图为 yml格式内容。