本文记录了在 Windows 11 系统下，使用 VSCode 搭建 Spring Boot 项目并集成 Nacos 的完整过程，包含环境配置、常见问题及解决方案。

一、环境准备

1.1 安装 JDK

推荐使用 JDK 17 或 JDK 21（Spring Boot 3.x 的最低要求）。

• 从 Oracle 官网 或 Adoptium 下载安装。
• 配置环境变量：
  • 新建系统变量 JAVA_HOME，值为 JDK 安装路径（如 C:\Program Files\Java\jdk-17）
  • 在 Path 中添加 %JAVA_HOME%\bin
• 验证：在 CMD 中执行 java -version 和 javac -version

1.2 安装 Maven

• 从 Maven 官网 下载二进制包，解压到无中文无空格的路径（如 D:\apache-maven-3.9.x）。
• 配置环境变量：
  • 新建系统变量 MAVEN_HOME，值为解压路径
  • 在 Path 中添加 %MAVEN_HOME%\bin
• 验证：mvn -v
• 配置本地仓库（可选）：修改 conf/settings.xml 中的 <localRepository>，建议放在非 C 盘。
• 配置国内镜像（加速依赖下载）：

<mirrors>
    <mirror>
        <id>aliyunmaven</id>
        <name>阿里云公共仓库</name>
        <url>https://maven.aliyun.com/repository/public</url>
        <mirrorOf>central</mirrorOf>
    </mirror>
</mirrors>

1.3 安装 VSCode

• 从 VSCode 官网 下载安装（不建议从微软商店安装，可能存在权限兼容问题）。
• 安装时建议勾选“添加到 PATH”。

二、VSCode 扩展安装

打开 VSCode，按 Ctrl+Shift+X 进入扩展市场，安装以下扩展包：

安装完成后，重启 VSCode 确保扩展生效。

三、VSCode Maven 配置

3.1 配置 JDK 和 Maven 路径

按 Ctrl+Shift+P → Preferences: Open User Settings (JSON)，添加：

{
    "java.configuration.runtimes": [
        {
            "name": "JavaSE-17",
            "path": "C:\\Program Files\\Java\\jdk-17",
            "default": true
        }
    ],
    "maven.executable.path": "D:\\apache-maven-3.9.x\\bin\\mvn.cmd",
    "maven.settingsFile": "D:\\apache-maven-3.9.x\\conf\\settings.xml",
    "java.configuration.detectJdksAtStart": false
}

路径请替换为你实际的安装路径。

3.2 检查 Maven 依赖加载状态

在 VSCode 中检查 Maven 依赖是否加载完成：

1. Maven 面板：点击左侧 Maven 图标，展开 Dependencies 节点，加载完成会显示完整依赖树。
2. 终端输出：按 Ctrl+` 打开终端，观察下载日志，完成后显示 BUILD SUCCESS。
3. 状态栏提示：底部状态栏显示 “Building workspace…” 表示还在加载，完成后恢复正常。
4. 代码验证：在 Java 代码中导入依赖类，无红色波浪线表示依赖已加载。

3.3 推荐插件查看依赖情况

四、创建 Spring Boot 项目

4.1 使用 Spring Initializr

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入 Spring Initializr: Create a Maven Project
3. 按提示选择：
   • Spring Boot 版本：选择稳定版（如 3.2.x 或 3.3.x）
   • 语言：Java
   • Group Id：如 com.example
   • Artifact Id：如 demo
   • 打包方式：Jar（推荐）
   • Java 版本：17 或 21
   • 依赖：至少选择 Spring Web
4. 选择项目保存目录，点击 Generate into folder
5. 生成完成后，点击提示中的 Open 打开项目

4.2 编写第一个接口

在 src/main/java/com/example/demo/ 下创建 HelloController.java：

package com.example.demo;

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

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hello, Spring Boot on VSCode!";
    }
}

启动项目后，浏览器访问 http://localhost:8080/hello 即可看到返回结果。

五、VSCode 与 IDEA Maven 配置差异问题

如果在 VSCode 中报 Non-resolvable parent POM 错误，而 IDEA 正常，通常是两者使用的 Maven 配置不一致。

解决方案

1. 确认 VSCode 使用相同的 Maven：

   • 终端执行 mvn help:effective-settings 查看实际配置
   • 对比 IDEA 和 VSCode 的 settings.xml 路径

2. 显式指定 Maven 配置：

{
    "maven.executable.path": "D:\\apache-maven-3.9.x\\bin\\mvn.cmd",
    "maven.settingsFile": "D:\\apache-maven-3.9.x\\conf\\settings.xml"
}

3. 强制更新依赖：

mvn clean install -U

4. 如果是私服依赖，确保 settings.xml 中配置了相同的仓库和认证信息。

六、常见问题汇总

九、版本兼容性参考

十、总结

在 Windows 11 + VSCode 环境下搭建 Spring Boot + Nacos 开发环境，核心要点：

1. 环境准备：JDK 17+、Maven 3.8+、VSCode 及扩展
2. Maven 配置：显式指定路径，配置国内镜像
3. Nacos 单机版：startup.cmd -m standalone 启动
4. 鉴权配置：Nacos 2.2.1+ 需要配置 token.secret.key 和 server.identity
5. 问题排查：对比 VSCode 和 IDEA 的 Maven 配置差异

相比 IntelliJ IDEA，VSCode 更轻量，启动更快，适合中小型 Spring Boot 项目的开发。