从 0 开始：在 WSL + VSCode 上利用 Maven 构建 Java Spring Boot 工程

🚀 从 0 开始：在 WSL + VSCode 上利用 Maven 构建 Java Spring Boot 工程

前言

是的，笔者今天速通了一下快速在WSL上搞Java SpringBoot的方法，基本上，基本的流程包括如下：

安装 JDK
安装 Maven
配置 VSCode Java 环境
使用 VSCode 生成 Spring Boot 项目
使用 Maven 构建并运行
写下你的第一个 Controller

1️⃣ 安装 WSL 并进入 Linux 环境

如果你已经安装 WSL，可以跳过。

bash 复制代码

wsl --install

推荐使用的发行版：

Arch Linux（Pacman 快）
Ubuntu（通用）
Debian（稳定）

启动：

bash 复制代码

wsl

2️⃣ 在 WSL 中安装 OpenJDK

Spring Boot 3.x 推荐 Java 17 或 Java 21，所以我们选 OpenJDK 21。

Arch Linux：

bash 复制代码

sudo pacman -Syu
sudo pacman -S jdk21-openjdk

Ubuntu/Debian：

bash 复制代码

sudo apt update
sudo apt install openjdk-21-jdk

验证：

bash 复制代码

java -version

输出示例：

复制代码

openjdk version "21.0.1" 2023-09-19

3️⃣ 安装 Maven

Spring Boot 默认使用 Maven 构建。

Arch：

bash 复制代码

sudo pacman -S maven

Ubuntu：

bash 复制代码

sudo apt install maven

验证：

bash 复制代码

mvn -v

4️⃣ 安装 VSCode 及必要扩展

在 Windows VSCode 中安装扩展：

WSL
Extension Pack for Java
Spring Boot Extension Pack
Spring Initializr Java Support

安装 WSL 扩展后，VSCode 会自动连接到你的 Linux。

启动方式：

复制代码

按 F1 → 输入：WSL: Connect to WSL → Arch / Ubuntu

5️⃣ 使用 VSCode 创建 Spring Boot 工程（最推荐）

这是最简单、最现代的方式。

▶ 步骤：

1. 打开 VSCode

在 VSCode 左下角点：

复制代码

><  打开远程窗口 → Connect to WSL

2. 打开你的工作目录

例如：

复制代码

/home/charlie/workspace

3. 按下 Ctrl + Shift + P

输入：

复制代码

Spring Initializr: Create a Maven Project

然后一路选择：

项目项	建议选择
Java Version	17 或 21
Project Type	Maven
Spring Boot	3.3.x
Group	com.example
Artifact	demo
Dependencies	Spring Web、Lombok 等

然后 VSCode 会自动生成项目并打开。

6️⃣ 运行 Spring Boot 项目

VSCode 右上角会出现：

复制代码

▶ Run | Debug Spring Boot

点击即可启动。

或用终端启动（推荐）：

bash 复制代码

mvn spring-boot:run

访问：

👉 http://localhost:8080

你已经成功启动 Spring Boot 应用了！

7️⃣ 创建你的第一个 Controller

在：

复制代码

src/main/java/com/example/demo/

新建 HelloController.java：

java 复制代码

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/")
    public String index() {
        return "Hello from Spring Boot on WSL!";
    }
}

重新运行：

bash 复制代码

mvn spring-boot:run

访问：

👉 http://localhost:8080/

你已成功运行你的第一个 Spring Boot Web API！

8️⃣ Maven 常用命令（速查表）

命令	作用
`mvn clean`	清理构建目录
`mvn package`	打包为 JAR
`mvn test`	执行测试
`mvn spring-boot:run`	开发模式启动
`./mvnw spring-boot:run`	使用 Maven Wrapper 启动

如果你希望项目不依赖全局 maven，可生成 wrapper：

bash 复制代码

mvn -N wrapper:wrapper