1. 别再纠结了VS Code 跑 Spring Boot 完全可行很多习惯了 IDEA 的同学一听到用 VS Code 写 Java 就摇头。我当年也是这么想的直到有次在轻薄本上开会IDEA 启动要两分钟风扇转得跟起飞似的临时改个接口参数都要等半天。那之后我认真把 VS Code 的 Java 环境折腾了一遍才发现它比我预想的成熟得多。现在我的日常开发就是 VS Code 为主、IDEA 为辅特别是写 Spring Boot 的小项目、Demo、接口测试VS Code 打开快、内存占用小体感非常舒服。这篇文章就把我踩过的坑和最终跑通的完整流程分享出来。你会在里面看到完整的扩展安装清单、环境变量配置、launch.json的写法以及各种奇怪报错的排查思路。无论你是刚接触 Spring Boot 想找个轻量工具试试还是被 IDEA 的性能折磨得想换个环境这份实操笔记应该都能帮到你。2. 为什么用 VS Code 跑 Spring Boot先解决“凭什么”的问题2.1 VS Code 不是玩具它的 Java 支持早就过了及格线先说点背景。VS Code 跑 Java 靠的是 Language Server Protocol语言服务器协议这套机制简单理解就是编辑器本身不解析 Java 代码它把“理解代码”这件事外包给一个后台进程也就是语言服务器。微软和 Red Hat 合作的 Java Extension Pack 里核心就是 Red Hat 开源的 Java Language Server。这个服务器负责代码补全、定义跳转、引用查找、错误提示这些功能代替了 IDEA 里那一大坨索引和分析引擎。有一个最常见的误解我必须澄清很多人以为 VS Code 写 Java 只是“能打开文件看看”实际上只要你把扩展装对、JDK 配好它的补全、重构、调试能力和 IDEA 的差距远没有想象中那么大。我实测过一个中型 Spring Boot 项目十几个实体类加几十个 ControllerVS Code 的跳转和补全速度甚至比 IDEA 还快——因为 IDEA 索引大项目时会有明显的延迟而 VS Code 按需加载。2.2 适合用 VS Code 的场景和人群我个人的使用体感是这样的如果你是做微服务、多模块大型工程或者重度依赖 IDEA 的付费插件生态那 VS Code 短期还替代不了 IDEA。但如果是下面这些场景VS Code 反而是更好的选择笔记本配置一般启动项目频繁受不了 IDEA 的内存开销。主要通过 Maven 构建不需要太多图形化的项目管理界面。项目里混杂了前端代码、YAML 配置、Shell 脚本、Docker 文件VS Code 的多语言支持比 IDEA 更轻快。学习 Spring Boot 阶段想快速看到效果不想第一次就被 IDE 的复杂配置劝退。有远程开发的习惯喜欢利用远程 SSH 插件直接改服务器上的代码。另外说个冷知识点VS Code 对 Maven 多模块项目的支持其实做得不错。只要安装了 Maven for Java 扩展它就能识别项目的模块结构在侧边栏里直接展示每个模块的依赖关系。对于聚合工程来说这个功能完全够用了。3. 环境准备装齐三件套少走一半弯路3.1 JDK版本选不对后面全是泪Spring Boot 3.x 要求 Java 17 起步Spring Boot 2.x 用 Java 8 或 11 都行。我的建议是直接装 JDK 17因为它是当前 Spring Boot 3 的主流版本而且绝大多数国内公司的生产环境已经切换到 17 了。如果你有老项目必须用 JDK 8也可以在 VS Code 里指定 Java 运行时版本这个后面会讲。安装完 JDK 记得把环境变量配好。Windows 下要新建JAVA_HOME指向 JDK 的安装根目录然后在Path里加上%JAVA_HOME%\bin。macOS 和 Linux 则是在~/.zshrc或~/.bashrc里加export JAVA_HOME$(/usr/libexec/java_home -v 17)这类配置有提示说这里的路径参数需要按实际 JDK 版本调整。这里有个非常容易踩的坑JDK 装好了java -version也正常但 VS Code 里总是提示“Java runtime not found”。原因通常是 VS Code 的 Java 扩展在启动时没有正确读取到环境变量。特别是 macOS 上GUI 应用不会自动继承终端里的 shell 配置。解决办法是先用which java找到 JDK 路径然后在 VS Code 的settings.json里手动指定下面会写具体配置。3.2 Maven不是必须装但建议装Spring Boot 项目一般都用 Maven 构建。你可以在本机安装独立 Maven也可以直接用项目自带的mvnwMaven Wrapper。我的习惯是本地装一份 Maven再配置阿里云镜像加速依赖下载。原因很简单mvnw首次运行时要下载对应版本的 Maven网络不好反而更慢。Maven 装好后同样要配置MAVEN_HOME或M2_HOME环境变量。不过 VS Code 的 Maven for Java 扩展会自己找 Maven找不到时再在设置里手动指定maven.executable.path就行。如果你用的是 IDEA 自带的 Maven并且只想在 VS Code 里跑项目强烈建议把 Maven 单独装一份避免两个工具抢同一个本地仓库出现版本冲突。3.3 扩展安装哪些必装哪些装了也是摆设打开 VS Code 的扩展面板搜索Java Extension Pack这是微软官方出的集合包里面包含六个扩展。我建议第一次装就装这个集合包然后把下面这几个留在启用状态扩展名作用必备程度Language Support for JavaJava 语言服务器负责补全、跳转、错误提示必装Debugger for JavaJava 调试器支持断点、变量查看、调用堆栈必装Maven for JavaMaven 项目管理和依赖解析必装Project Manager for Java显示项目结构、类路径、依赖树建议装Test Runner for Java单元测试运行和结果展示建议装Spring Boot Extension Pack含 Spring Boot 工具、Spring Initializr 等跑 Spring Boot 必装注意Spring Boot 项目还需要装Spring Boot Extension Pack它里面包含了 Spring Boot 相关的配置提示、项目初始化向导等。不装这个也能跑但装了之后写application.yml会有配置项补全Controller 里也会多出一些 Spring 特有的代码提示体验好很多。3.4 settings.json 里的关键配置装完扩展第一次启动 Java 项目时VS Code 会弹通知提示配置 Java Home。如果弹窗没出现或者你想手动锁定 JDK 版本可以打开命令面板CtrlShiftP输入Preferences: Open Settings (JSON)把下面这段加进去{ java.configuration.runtimes: [ { name: JavaSE-17, path: /usr/local/jdk-17.0.5, default: true } ], maven.executable.path: /usr/local/maven/bin/mvn, java.compile.nullAnalysis.mode: automatic, java.debug.settings.hotCodeReplace: auto, java.debug.settings.vmArgs: -Xmx512m }java.configuration.runtimes数组里可以同时配置多个 JDK 版本然后把其中一个设为default。如果你的机器上装了 JDK 8 和 JDK 17想跑某个老项目时可以在这个配置里新增一条 JDK 8 的项然后在 VS Code 底部状态栏点击 Java 版本号快速切换。这个功能实测很稳比在系统环境变量里来回改方便得多。4. 实操全过程从克隆项目到第一个请求返回4.1 导入项目的正确姿势VS Code 打开 Spring Boot 项目有两种方式。第一种是文件 - 打开文件夹直接选择项目根目录。第二种是在命令面板里执行Java: Import Java Projects in Workspace。两种方式最终都会让 Language Server 扫描类路径并生成依赖。我推荐用第一种简单直接。打开后 VS Code 会自动检测到pom.xml右下角弹出“Java projects need to be imported”之类的提示点击确认即可。如果你打开项目后发现侧边栏没有 Maven 模块视图别慌找到资源管理器下方的“Maven”面板刷新一下项目就会开始解析依赖。首次解析会下载所有依赖包耗时取决于网络速度和仓库镜像配置通常三五分钟起步。有个细节值得留意项目导入阶段VS Code 的 CPU 占用会飙升这是转储类路径的正常现象。不要在这个时候强行关闭窗口否则可能留下损坏的索引缓存导致后续一直报找不到类。4.2 首次运行 Spring Boot 项目两种启动方式方式一Maven 面板启动在 VS Code 侧边栏找到 Maven 面板展开项目找到spring-boot:run这个命令它会自动执行 Maven 的 Spring Boot 插件并启动应用。点击后下方终端会输出日志看到 “Started Application in X seconds” 就说明启动成功了。这种方式适合刚接触 Maven 的同学省心省力。但有一点要注意Maven 面板启动时命令行参数和 VM 参数的调优余地不大如果你需要自定义 JVM 参数还是得回到命令行方式。方式二终端里 mvn spring-boot:run我更推荐这种方式因为你能直观看到完整的 Maven 输出和日志mvn spring-boot:run如果你用了 Maven Wrapper则执行./mvnw spring-boot:run启动后访问http://localhost:8080正常情况下你应该能看到 Spring Boot 的默认错误页因为还没配置任何接口或者你自己的首页。如果你配置了 Spring Data JPA启动日志里会看到 Hibernate 建表语句之类的输出这些都是正常现象。这里补充一个很多人不知道的小技巧开发环境中你可以直接在启动命令后面带-Dspring-boot.run.profilesdev来指定使用application-dev.yml配置。比如mvn spring-boot:run -Dspring-boot.run.profilesdev如果你的项目有多个环境配置这个参数切换环境非常方便。4.3 重大更新VS Code 自带的“运行”按钮新版 VS Code 针对 Java 项目增加了运行按钮支持。当你打开 Spring Boot 项目时编辑器右上角会出现一个三角形运行图标。点击它VS Code 会使用 Debugger for Java 扩展来启动当前主类。这个功能的好处是不依赖终端直接启动并且会主动识别SpringBootApplication注解标记的入口类。我用下来发现这个方式最大的优点是启动成功后控制台里会显示进程 ID、端口号、占用 CPU/内存等信息调试起来非常清晰。但从终端启动的方式能让你看到更完整的 Maven 构建输出各有利弊。我的习惯是日常写代码调试用运行按钮需要看清楚构建流程时用终端。4.4 配置数据源最容易被忽略的启动坑Spring Boot 项目最常见的启动失败原因不是代码写错而是数据源配置缺失或错误。如果你项目引入了spring-boot-starter-data-jpa或spring-boot-starter-jdbc但application.yml里没有配置数据库连接启动时大概率会报错提示无法确定 DataSource 类型。解决办法有两个在pom.xml里排除自动数据源配置exclusions exclusion groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /exclusion /exclusions在application.yml里配置一个最小可用的数据源spring: datasource: url: jdbc:mysql://localhost:3306/test?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver第二种方式更优雅因为你后面要连数据库迟早要配置。注意MySQL 8 的驱动类名是com.mysql.cj.jdbc.Driver不是老版本的com.mysql.jdbc.Driver这个坑我踩过一次报错信息提示会让你折腾半天。5. 调试断点不只是 IDEA 的专属能力5.1 写个最简单的断点调试实例VS Code 的 Java 调试能力经常被低估其实它支持完整的断点调试、变量查看、调用堆栈、热替换。下面我通过一个具体例子演示怎么操作。假设你有这样一个 ControllerRestController RequestMapping(/api/user) public class UserController { GetMapping(/{id}) public User getUser(PathVariable Long id) { User user new User(); user.setId(id); user.setName(测试用户 id); return user; } }启动调试模式后在return user;这一行左侧点击一下设置断点然后浏览器访问http://localhost:8080/api/user/1VS Code 会自动停在断点处。左侧面板会显示所有局部变量的当前值你可以展开user对象查看字段内容也可以通过右上角的步进按钮逐行执行。调试时按 F5 启动、F10 单步跳过、F11 单步进入、ShiftF5 退出这些快捷键和 IDEA 完全一致不需要重新学习记忆。5.2 launch.json自定义调试配置的精髓如果你需要自定义调试启动方式比如指定环境变量、调整启动端口、设置 Spring Boot 的 profile就需要写launch.json文件。在 VS Code 里按 CtrlShiftD 打开调试面板点击创建配置文件选择 Java 环境VS Code 会自动生成一份基础配置。我改造后的配置如下{ version: 0.2.0, configurations: [ { type: java, name: 启动当前Spring Boot应用, request: launch, mainClass: com.example.demo.DemoApplication, projectName: demo, env: { SPRING_PROFILES_ACTIVE: dev, JAVA_OPTS: -Xmx512m }, args: --server.port8081 } ] }这个配置里mainClass指定入口类env里通过SPRING_PROFILES_ACTIVE环境变量指定当前加载的 profile 为 devargs里用--server.port8081把服务端口改成 8081。保存后调试面板里会出现一个“启动当前Spring Boot应用”的配置项点击绿色播放按钮即可启动。看明白了吗VS Code 的调试配置够灵活吧其实不比 IDEA 的 Run Configuration 弱。遇到端口冲突时直接在args里改端口就行不用动代码也不用改配置文件。5.3 热替换的真相与限制Java 的 Hot Code Replace热替换在 VS Code 里是默认开启的。也就是说调试运行状态下修改方法体内部的代码保存后无需重启就能生效。但要记住一个限制新增方法、修改方法签名、修改类的继承关系这类结构性变更不支持热替换只能重启应用。我建议你在开发阶段把java.debug.settings.hotCodeReplace设为auto这样 VS Code 可以在热替换失败时自动切换为“强制重启”模式省掉手动重启的麻烦。这个细节网上很少有人提到反正对我是很实用的。6. 多模块 Spring Boot 项目的运行细节6.1 认识 Maven 多模块结构真实项目里Spring Boot 很少是单模块的。常见结构是这样parent-project ├── pom.xml (父POM管理依赖版本) ├── common-module (公共模块实体类、工具类) ├── service-module (业务模块Service、Mapper) └── web-module (Web模块Controller、启动类)在 VS Code 里打开父项目根目录Maven for Java 扩展会识别出所有子模块。每个模块在 Maven 面板里都能展开并且 Language Server 会为每个模块单独记录类路径。这个功能是自动完成的不需要手动配置。6.2 运行子模块的入口类如果你要启动web-module模块里的启动类不用切换目录直接在 VS Code 的 Java 项目中找到这个模块右键运行主类即可。或者按 F1 调出命令面板输入Java: Run Main Class选择对应模块的Application类。模块之间的依赖关系在 VS Code 里也能看到。当你修改了common-module里的实体类保存后引用该模块的web-module会收到编译错误或提示。这里有个注意点修改了公共模块后需要让 Maven 先安装公共模块到本地仓库才能保证其他模块的类路径是最新的。命令行执行mvn clean install -DskipTests如果漏掉这一步就会出现“明明改了代码但另一个模块报错找不到方法”这种灵异事件。6.3 多模块的项目导入耗时过长怎么办项目模块多了以后首次导入的耗时可能长达十几分钟。这是因为 Language Server 需要编译整个项目图。解决办法有两个给 Maven 配置国内镜像加快依赖下载速度。在 Maven 的settings.xml里加入阿里云镜像。把用不到的测试依赖单独建一个 profile避免全量解析。提到设置镜像这个操作我顺手贴一下配置片段放在 Maven 的conf/settings.xml里mirror idaliyunmaven/id mirrorOfcentral/mirrorOf namealiyun maven repository/name urlhttps://maven.aliyun.com/repository/public/url /mirror配好之后依赖下载速度会明显提升。首次启动的等待时间能缩短一大半。7. 常见问题与排查技巧踩过的坑逐个说7.1 启动时报错找不到或无法加载主类这个错误绝大多数情况下不是 VS Code 的问题而是项目的编译输出目录和 Maven 的 target 目录不一致。VS Code 使用自己的输出目录out来存放编译结果如果你清除了编译缓存或者用 IDEA 打开过项目有可能导致 classpath 混乱。最直接的解决办法是mvn clean compile然后回到 VS Code删除所有输出目录workspace 存储重新导入。在命令面板执行Java: Clean Java Language Server Workspace这是清理工具实测能解决很多诡异的问题。执行完会重载窗口重新构建索引。7.2 明明没写错误但红波浪线一直在飘这个问题通常是 Language Server 的状态不同步导致的。Spring Boot 项目里application.yml中配置的属性如果在代码中引用了Language Server 有时会误报“无法解析属性”。我的排查经验是这样的先确认 Maven 依赖是否下载完整缺依赖时 Language Server 会大量报错。再确认 JDK 版本是否匹配 Spring Boot 版本要求。Spring Boot 3 用 JDK 8 跑编译器会报版本错误。如果上面两项都正常尝试执行命令Java: Reload Projects强制刷新类路径。如果是配置属性误报可以给启动类加ConfigurationPropertiesScan注解或者直接用Value注入Language Server 一般就不再红波浪了。7.3 端口被占用Address already in use开发中最常见的启动失败原因。排查方式netstat -ano | findstr :8080 taskkill /F /PID 进程号macOS/Linux 则是lsof -i :8080 kill -9 PID然后重新启动。如果经常遇到端口冲突可以在launch.json的args里固定一个不常用端口比如 8090。这样能省掉每次改动配置文件的麻烦。7.4 Lombok 不生效代码全是红色VS Code 的 Java 扩展对 Lombok 的支持默认是开启的但偶尔会出现不生效的情况。检查下面三个地方pom.xml中是否加了最新的 Lombok 版本。VS Code 窗口右下角是否提示安装 Lombok 支持。运行命令mvn clean compile后观察是否恢复正常。如果还是不生效在settings.json中添加如下配置java.lombok.version: 1.18.28, java.lombok.lombokPath: ~/.m2/repository/org/projectlombok/lombok/1.18.28/lombok-1.18.28.jar注意版本号要和pom.xml里的一致。设置完重启 VS Code 即可。7.5 项目导入后 Spring 相关注解不识别出现Autowired、Service等注解标红但项目能正常编译运行这种情况多数是 Language Server 对 Spring 扩展的加载出现了滞后。先看扩展面板里Spring Boot Extension Pack是否已启用然后执行Java: Reload Projects。如果还有问题把项目从工作区移除再重新加入通常就恢复了。7.6 控制台输出中文乱码Windows 下比较常见。默认编码问题导致控制台日志里的中文变成乱码。解决办法是在launch.json里给当前的调试配置添加一个控制台选项console: integratedTerminal, vmArgs: -Dfile.encodingUTF-8同时在settings.json里设置terminal.integrated.defaultProfile.windows: Command Prompt, terminal.integrated.shellArgs.windows: [/K, chcp 65001]这个方法我实测有效。如果用的是 Maven 命令启动可以在.mvn/jvm.config文件中加入-Dfile.encodingUTF-8。8. 进阶建议让 VS Code 真正成为日常主力8.1 善用命令面板效率翻倍VS Code 高度依赖快捷键和命令面板。开发 Spring Boot 项目时高频操作主要有这些CtrlShiftP输入Java: Run Main Class快速启动任意模块的入口类。CtrlShiftP输入Java: Reload Projects刷新类路径依赖。CtrlShiftP输入Spring Initializr: Create a Maven Project直接在当前工作区生成一个全新的 Spring Boot 项目。CtrlShiftP输入Java: Open Java Extension Pack查看所有 Java 扩展的详细文档。我见过太多人只用鼠标点来点去不熟悉命令面板白白浪费了 VS Code 最强大的功能。8.2 扩展推荐好用到飞起的配置除了官方扩展之外下面这些扩展也值得装EditorConfig for VS Code统一项目代码风格。SonarLint实时提示代码质量问题包括安全漏洞。YAMLapplication.yml文件的格式化、校验、补全。Docker配合docker-compose.yml启动本地中间件。GitLens查看代码提交历史、Git blame排查问题利器。注意扩展不是越多越好装多了会拖慢 VS Code 启动速度。每个扩展占用的内存和解析时间会叠加所以建议只装真正用得到的。8.3 元件的性能调优VS Code 卡顿排查VS Code 本身占用内存不大但运行 Java 语言服务器时内存会涨到几百 MB。如果项目很大建议在settings.json中限制 Java 语言服务器的堆内存java.server.launchMode: Standard, java.server.vmargs: -Xmx1024m -XX:UseParallelGC另外VS Code 的 workspace 存储目录Windows 下是%APPDATA%\Code\User\workspaceStorage里塞满了很多项目缓存时间长了会拖慢整体性能。建议定期清理这个目录让 VS Code 重新建立索引。我一般一个月清理一次清理之后明显感觉轻快不少。8.4 远程开发另一种高效工作流如果你是在公司服务器上开发或者习惯用云主机跑应用VS Code 的 Remote SSH 插件几乎是神器。本地写代码远程服务器编译运行所有依赖都装在云端本地电脑不需要高性能硬件。具体流程安装Remote - SSH扩展配置好 SSH 访问信息连接远程主机然后在远程 VS Code 窗口里打开项目。远程环境下 Java 扩展一样能用补全、调试、断点全部支持只是代码解析在云端完成。这种方式对笔记本用户尤其友好电脑温度会低很多。9. 一些操作心得和习惯建议在多次使用 VS Code 跑 Spring Boot 的过程中我总结了一些属于自己的习惯这些都是慢慢摸索出来的并不代表最优解仅供参考。第一我习惯给每个分支项目单独设置一个 VS Code 窗口。Spring Boot 项目多分支切换时同一窗口内重新加载类路径很慢而新开窗口可以让 Language Server 重新构建索引不容易出现旧编译信息干扰的问题。第二命令行启动和调试启动交替使用。日常验证代码逻辑时我更倾向直接点击运行按钮快速启动需要分析依赖、查看构建细节时切到终端执行mvn spring-boot:run -X查看 Maven 的调试输出。-X参数会输出 Maven 的完整调试日志排查依赖冲突时非常有用。第三关于断点调试我习惯在 Controller 的入口和关键业务方法各打一个断点再配合 VS Code 的变量面板查看数据变化。遇到问题时先从调用栈底部往上定位大部分 bug 都能在半小时内解决。第四是事件日志习惯。Spring Boot 的启动日志默认包含很多 debug 信息开发时不需要每次都全量输出。建议在application.yml里把logging.level设置为合适的级别比如只打印项目包名下的 INFO 日志其他第三方库保持 WARN这样日志清爽很多。说到底工具终归是工具。IDEA 很强大VS Code 很轻量谁也不必替代谁。如果你还在犹豫要不要换我的建议是先拿一个小项目试试跑通一个完整的 Spring Boot CRUD 流程你自然会有答案。 
长河君 · 2026/10/16 20:11:43 · 阅读 1.2k VS Code跑Spring Boot全攻略：从环境配置到断点调试的高效开发实践
1. 别再纠结了VS Code 跑 Spring Boot 完全可行很多习惯了 IDEA 的同学一听到用 VS Code 写 Java 就摇头。我当年也是这么想的直到有次在轻薄本上开会IDEA 启动要两分钟风扇转得跟起飞似的临时改个接口参数都要等半天。那之后我认真把 VS Code 的 Java 环境折腾了一遍才发现它比我预想的成熟得多。现在我的日常开发就是 VS Code 为主、IDEA 为辅特别是写 Spring Boot 的小项目、Demo、接口测试VS Code 打开快、内存占用小体感非常舒服。这篇文章就把我踩过的坑和最终跑通的完整流程分享出来。你会在里面看到完整的扩展安装清单、环境变量配置、launch.json的写法以及各种奇怪报错的排查思路。无论你是刚接触 Spring Boot 想找个轻量工具试试还是被 IDEA 的性能折磨得想换个环境这份实操笔记应该都能帮到你。2. 为什么用 VS Code 跑 Spring Boot先解决“凭什么”的问题2.1 VS Code 不是玩具它的 Java 支持早就过了及格线先说点背景。VS Code 跑 Java 靠的是 Language Server Protocol语言服务器协议这套机制简单理解就是编辑器本身不解析 Java 代码它把“理解代码”这件事外包给一个后台进程也就是语言服务器。微软和 Red Hat 合作的 Java Extension Pack 里核心就是 Red Hat 开源的 Java Language Server。这个服务器负责代码补全、定义跳转、引用查找、错误提示这些功能代替了 IDEA 里那一大坨索引和分析引擎。有一个最常见的误解我必须澄清很多人以为 VS Code 写 Java 只是“能打开文件看看”实际上只要你把扩展装对、JDK 配好它的补全、重构、调试能力和 IDEA 的差距远没有想象中那么大。我实测过一个中型 Spring Boot 项目十几个实体类加几十个 ControllerVS Code 的跳转和补全速度甚至比 IDEA 还快——因为 IDEA 索引大项目时会有明显的延迟而 VS Code 按需加载。2.2 适合用 VS Code 的场景和人群我个人的使用体感是这样的如果你是做微服务、多模块大型工程或者重度依赖 IDEA 的付费插件生态那 VS Code 短期还替代不了 IDEA。但如果是下面这些场景VS Code 反而是更好的选择笔记本配置一般启动项目频繁受不了 IDEA 的内存开销。主要通过 Maven 构建不需要太多图形化的项目管理界面。项目里混杂了前端代码、YAML 配置、Shell 脚本、Docker 文件VS Code 的多语言支持比 IDEA 更轻快。学习 Spring Boot 阶段想快速看到效果不想第一次就被 IDE 的复杂配置劝退。有远程开发的习惯喜欢利用远程 SSH 插件直接改服务器上的代码。另外说个冷知识点VS Code 对 Maven 多模块项目的支持其实做得不错。只要安装了 Maven for Java 扩展它就能识别项目的模块结构在侧边栏里直接展示每个模块的依赖关系。对于聚合工程来说这个功能完全够用了。3. 环境准备装齐三件套少走一半弯路3.1 JDK版本选不对后面全是泪Spring Boot 3.x 要求 Java 17 起步Spring Boot 2.x 用 Java 8 或 11 都行。我的建议是直接装 JDK 17因为它是当前 Spring Boot 3 的主流版本而且绝大多数国内公司的生产环境已经切换到 17 了。如果你有老项目必须用 JDK 8也可以在 VS Code 里指定 Java 运行时版本这个后面会讲。安装完 JDK 记得把环境变量配好。Windows 下要新建JAVA_HOME指向 JDK 的安装根目录然后在Path里加上%JAVA_HOME%\bin。macOS 和 Linux 则是在~/.zshrc或~/.bashrc里加export JAVA_HOME$(/usr/libexec/java_home -v 17)这类配置有提示说这里的路径参数需要按实际 JDK 版本调整。这里有个非常容易踩的坑JDK 装好了java -version也正常但 VS Code 里总是提示“Java runtime not found”。原因通常是 VS Code 的 Java 扩展在启动时没有正确读取到环境变量。特别是 macOS 上GUI 应用不会自动继承终端里的 shell 配置。解决办法是先用which java找到 JDK 路径然后在 VS Code 的settings.json里手动指定下面会写具体配置。3.2 Maven不是必须装但建议装Spring Boot 项目一般都用 Maven 构建。你可以在本机安装独立 Maven也可以直接用项目自带的mvnwMaven Wrapper。我的习惯是本地装一份 Maven再配置阿里云镜像加速依赖下载。原因很简单mvnw首次运行时要下载对应版本的 Maven网络不好反而更慢。Maven 装好后同样要配置MAVEN_HOME或M2_HOME环境变量。不过 VS Code 的 Maven for Java 扩展会自己找 Maven找不到时再在设置里手动指定maven.executable.path就行。如果你用的是 IDEA 自带的 Maven并且只想在 VS Code 里跑项目强烈建议把 Maven 单独装一份避免两个工具抢同一个本地仓库出现版本冲突。3.3 扩展安装哪些必装哪些装了也是摆设打开 VS Code 的扩展面板搜索Java Extension Pack这是微软官方出的集合包里面包含六个扩展。我建议第一次装就装这个集合包然后把下面这几个留在启用状态扩展名作用必备程度Language Support for JavaJava 语言服务器负责补全、跳转、错误提示必装Debugger for JavaJava 调试器支持断点、变量查看、调用堆栈必装Maven for JavaMaven 项目管理和依赖解析必装Project Manager for Java显示项目结构、类路径、依赖树建议装Test Runner for Java单元测试运行和结果展示建议装Spring Boot Extension Pack含 Spring Boot 工具、Spring Initializr 等跑 Spring Boot 必装注意Spring Boot 项目还需要装Spring Boot Extension Pack它里面包含了 Spring Boot 相关的配置提示、项目初始化向导等。不装这个也能跑但装了之后写application.yml会有配置项补全Controller 里也会多出一些 Spring 特有的代码提示体验好很多。3.4 settings.json 里的关键配置装完扩展第一次启动 Java 项目时VS Code 会弹通知提示配置 Java Home。如果弹窗没出现或者你想手动锁定 JDK 版本可以打开命令面板CtrlShiftP输入Preferences: Open Settings (JSON)把下面这段加进去{ java.configuration.runtimes: [ { name: JavaSE-17, path: /usr/local/jdk-17.0.5, default: true } ], maven.executable.path: /usr/local/maven/bin/mvn, java.compile.nullAnalysis.mode: automatic, java.debug.settings.hotCodeReplace: auto, java.debug.settings.vmArgs: -Xmx512m }java.configuration.runtimes数组里可以同时配置多个 JDK 版本然后把其中一个设为default。如果你的机器上装了 JDK 8 和 JDK 17想跑某个老项目时可以在这个配置里新增一条 JDK 8 的项然后在 VS Code 底部状态栏点击 Java 版本号快速切换。这个功能实测很稳比在系统环境变量里来回改方便得多。4. 实操全过程从克隆项目到第一个请求返回4.1 导入项目的正确姿势VS Code 打开 Spring Boot 项目有两种方式。第一种是文件 - 打开文件夹直接选择项目根目录。第二种是在命令面板里执行Java: Import Java Projects in Workspace。两种方式最终都会让 Language Server 扫描类路径并生成依赖。我推荐用第一种简单直接。打开后 VS Code 会自动检测到pom.xml右下角弹出“Java projects need to be imported”之类的提示点击确认即可。如果你打开项目后发现侧边栏没有 Maven 模块视图别慌找到资源管理器下方的“Maven”面板刷新一下项目就会开始解析依赖。首次解析会下载所有依赖包耗时取决于网络速度和仓库镜像配置通常三五分钟起步。有个细节值得留意项目导入阶段VS Code 的 CPU 占用会飙升这是转储类路径的正常现象。不要在这个时候强行关闭窗口否则可能留下损坏的索引缓存导致后续一直报找不到类。4.2 首次运行 Spring Boot 项目两种启动方式方式一Maven 面板启动在 VS Code 侧边栏找到 Maven 面板展开项目找到spring-boot:run这个命令它会自动执行 Maven 的 Spring Boot 插件并启动应用。点击后下方终端会输出日志看到 “Started Application in X seconds” 就说明启动成功了。这种方式适合刚接触 Maven 的同学省心省力。但有一点要注意Maven 面板启动时命令行参数和 VM 参数的调优余地不大如果你需要自定义 JVM 参数还是得回到命令行方式。方式二终端里 mvn spring-boot:run我更推荐这种方式因为你能直观看到完整的 Maven 输出和日志mvn spring-boot:run如果你用了 Maven Wrapper则执行./mvnw spring-boot:run启动后访问http://localhost:8080正常情况下你应该能看到 Spring Boot 的默认错误页因为还没配置任何接口或者你自己的首页。如果你配置了 Spring Data JPA启动日志里会看到 Hibernate 建表语句之类的输出这些都是正常现象。这里补充一个很多人不知道的小技巧开发环境中你可以直接在启动命令后面带-Dspring-boot.run.profilesdev来指定使用application-dev.yml配置。比如mvn spring-boot:run -Dspring-boot.run.profilesdev如果你的项目有多个环境配置这个参数切换环境非常方便。4.3 重大更新VS Code 自带的“运行”按钮新版 VS Code 针对 Java 项目增加了运行按钮支持。当你打开 Spring Boot 项目时编辑器右上角会出现一个三角形运行图标。点击它VS Code 会使用 Debugger for Java 扩展来启动当前主类。这个功能的好处是不依赖终端直接启动并且会主动识别SpringBootApplication注解标记的入口类。我用下来发现这个方式最大的优点是启动成功后控制台里会显示进程 ID、端口号、占用 CPU/内存等信息调试起来非常清晰。但从终端启动的方式能让你看到更完整的 Maven 构建输出各有利弊。我的习惯是日常写代码调试用运行按钮需要看清楚构建流程时用终端。4.4 配置数据源最容易被忽略的启动坑Spring Boot 项目最常见的启动失败原因不是代码写错而是数据源配置缺失或错误。如果你项目引入了spring-boot-starter-data-jpa或spring-boot-starter-jdbc但application.yml里没有配置数据库连接启动时大概率会报错提示无法确定 DataSource 类型。解决办法有两个在pom.xml里排除自动数据源配置exclusions exclusion groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /exclusion /exclusions在application.yml里配置一个最小可用的数据源spring: datasource: url: jdbc:mysql://localhost:3306/test?useUnicodetruecharacterEncodingutf-8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver第二种方式更优雅因为你后面要连数据库迟早要配置。注意MySQL 8 的驱动类名是com.mysql.cj.jdbc.Driver不是老版本的com.mysql.jdbc.Driver这个坑我踩过一次报错信息提示会让你折腾半天。5. 调试断点不只是 IDEA 的专属能力5.1 写个最简单的断点调试实例VS Code 的 Java 调试能力经常被低估其实它支持完整的断点调试、变量查看、调用堆栈、热替换。下面我通过一个具体例子演示怎么操作。假设你有这样一个 ControllerRestController RequestMapping(/api/user) public class UserController { GetMapping(/{id}) public User getUser(PathVariable Long id) { User user new User(); user.setId(id); user.setName(测试用户 id); return user; } }启动调试模式后在return user;这一行左侧点击一下设置断点然后浏览器访问http://localhost:8080/api/user/1VS Code 会自动停在断点处。左侧面板会显示所有局部变量的当前值你可以展开user对象查看字段内容也可以通过右上角的步进按钮逐行执行。调试时按 F5 启动、F10 单步跳过、F11 单步进入、ShiftF5 退出这些快捷键和 IDEA 完全一致不需要重新学习记忆。5.2 launch.json自定义调试配置的精髓如果你需要自定义调试启动方式比如指定环境变量、调整启动端口、设置 Spring Boot 的 profile就需要写launch.json文件。在 VS Code 里按 CtrlShiftD 打开调试面板点击创建配置文件选择 Java 环境VS Code 会自动生成一份基础配置。我改造后的配置如下{ version: 0.2.0, configurations: [ { type: java, name: 启动当前Spring Boot应用, request: launch, mainClass: com.example.demo.DemoApplication, projectName: demo, env: { SPRING_PROFILES_ACTIVE: dev, JAVA_OPTS: -Xmx512m }, args: --server.port8081 } ] }这个配置里mainClass指定入口类env里通过SPRING_PROFILES_ACTIVE环境变量指定当前加载的 profile 为 devargs里用--server.port8081把服务端口改成 8081。保存后调试面板里会出现一个“启动当前Spring Boot应用”的配置项点击绿色播放按钮即可启动。看明白了吗VS Code 的调试配置够灵活吧其实不比 IDEA 的 Run Configuration 弱。遇到端口冲突时直接在args里改端口就行不用动代码也不用改配置文件。5.3 热替换的真相与限制Java 的 Hot Code Replace热替换在 VS Code 里是默认开启的。也就是说调试运行状态下修改方法体内部的代码保存后无需重启就能生效。但要记住一个限制新增方法、修改方法签名、修改类的继承关系这类结构性变更不支持热替换只能重启应用。我建议你在开发阶段把java.debug.settings.hotCodeReplace设为auto这样 VS Code 可以在热替换失败时自动切换为“强制重启”模式省掉手动重启的麻烦。这个细节网上很少有人提到反正对我是很实用的。6. 多模块 Spring Boot 项目的运行细节6.1 认识 Maven 多模块结构真实项目里Spring Boot 很少是单模块的。常见结构是这样parent-project ├── pom.xml (父POM管理依赖版本) ├── common-module (公共模块实体类、工具类) ├── service-module (业务模块Service、Mapper) └── web-module (Web模块Controller、启动类)在 VS Code 里打开父项目根目录Maven for Java 扩展会识别出所有子模块。每个模块在 Maven 面板里都能展开并且 Language Server 会为每个模块单独记录类路径。这个功能是自动完成的不需要手动配置。6.2 运行子模块的入口类如果你要启动web-module模块里的启动类不用切换目录直接在 VS Code 的 Java 项目中找到这个模块右键运行主类即可。或者按 F1 调出命令面板输入Java: Run Main Class选择对应模块的Application类。模块之间的依赖关系在 VS Code 里也能看到。当你修改了common-module里的实体类保存后引用该模块的web-module会收到编译错误或提示。这里有个注意点修改了公共模块后需要让 Maven 先安装公共模块到本地仓库才能保证其他模块的类路径是最新的。命令行执行mvn clean install -DskipTests如果漏掉这一步就会出现“明明改了代码但另一个模块报错找不到方法”这种灵异事件。6.3 多模块的项目导入耗时过长怎么办项目模块多了以后首次导入的耗时可能长达十几分钟。这是因为 Language Server 需要编译整个项目图。解决办法有两个给 Maven 配置国内镜像加快依赖下载速度。在 Maven 的settings.xml里加入阿里云镜像。把用不到的测试依赖单独建一个 profile避免全量解析。提到设置镜像这个操作我顺手贴一下配置片段放在 Maven 的conf/settings.xml里mirror idaliyunmaven/id mirrorOfcentral/mirrorOf namealiyun maven repository/name urlhttps://maven.aliyun.com/repository/public/url /mirror配好之后依赖下载速度会明显提升。首次启动的等待时间能缩短一大半。7. 常见问题与排查技巧踩过的坑逐个说7.1 启动时报错找不到或无法加载主类这个错误绝大多数情况下不是 VS Code 的问题而是项目的编译输出目录和 Maven 的 target 目录不一致。VS Code 使用自己的输出目录out来存放编译结果如果你清除了编译缓存或者用 IDEA 打开过项目有可能导致 classpath 混乱。最直接的解决办法是mvn clean compile然后回到 VS Code删除所有输出目录workspace 存储重新导入。在命令面板执行Java: Clean Java Language Server Workspace这是清理工具实测能解决很多诡异的问题。执行完会重载窗口重新构建索引。7.2 明明没写错误但红波浪线一直在飘这个问题通常是 Language Server 的状态不同步导致的。Spring Boot 项目里application.yml中配置的属性如果在代码中引用了Language Server 有时会误报“无法解析属性”。我的排查经验是这样的先确认 Maven 依赖是否下载完整缺依赖时 Language Server 会大量报错。再确认 JDK 版本是否匹配 Spring Boot 版本要求。Spring Boot 3 用 JDK 8 跑编译器会报版本错误。如果上面两项都正常尝试执行命令Java: Reload Projects强制刷新类路径。如果是配置属性误报可以给启动类加ConfigurationPropertiesScan注解或者直接用Value注入Language Server 一般就不再红波浪了。7.3 端口被占用Address already in use开发中最常见的启动失败原因。排查方式netstat -ano | findstr :8080 taskkill /F /PID 进程号macOS/Linux 则是lsof -i :8080 kill -9 PID然后重新启动。如果经常遇到端口冲突可以在launch.json的args里固定一个不常用端口比如 8090。这样能省掉每次改动配置文件的麻烦。7.4 Lombok 不生效代码全是红色VS Code 的 Java 扩展对 Lombok 的支持默认是开启的但偶尔会出现不生效的情况。检查下面三个地方pom.xml中是否加了最新的 Lombok 版本。VS Code 窗口右下角是否提示安装 Lombok 支持。运行命令mvn clean compile后观察是否恢复正常。如果还是不生效在settings.json中添加如下配置java.lombok.version: 1.18.28, java.lombok.lombokPath: ~/.m2/repository/org/projectlombok/lombok/1.18.28/lombok-1.18.28.jar注意版本号要和pom.xml里的一致。设置完重启 VS Code 即可。7.5 项目导入后 Spring 相关注解不识别出现Autowired、Service等注解标红但项目能正常编译运行这种情况多数是 Language Server 对 Spring 扩展的加载出现了滞后。先看扩展面板里Spring Boot Extension Pack是否已启用然后执行Java: Reload Projects。如果还有问题把项目从工作区移除再重新加入通常就恢复了。7.6 控制台输出中文乱码Windows 下比较常见。默认编码问题导致控制台日志里的中文变成乱码。解决办法是在launch.json里给当前的调试配置添加一个控制台选项console: integratedTerminal, vmArgs: -Dfile.encodingUTF-8同时在settings.json里设置terminal.integrated.defaultProfile.windows: Command Prompt, terminal.integrated.shellArgs.windows: [/K, chcp 65001]这个方法我实测有效。如果用的是 Maven 命令启动可以在.mvn/jvm.config文件中加入-Dfile.encodingUTF-8。8. 进阶建议让 VS Code 真正成为日常主力8.1 善用命令面板效率翻倍VS Code 高度依赖快捷键和命令面板。开发 Spring Boot 项目时高频操作主要有这些CtrlShiftP输入Java: Run Main Class快速启动任意模块的入口类。CtrlShiftP输入Java: Reload Projects刷新类路径依赖。CtrlShiftP输入Spring Initializr: Create a Maven Project直接在当前工作区生成一个全新的 Spring Boot 项目。CtrlShiftP输入Java: Open Java Extension Pack查看所有 Java 扩展的详细文档。我见过太多人只用鼠标点来点去不熟悉命令面板白白浪费了 VS Code 最强大的功能。8.2 扩展推荐好用到飞起的配置除了官方扩展之外下面这些扩展也值得装EditorConfig for VS Code统一项目代码风格。SonarLint实时提示代码质量问题包括安全漏洞。YAMLapplication.yml文件的格式化、校验、补全。Docker配合docker-compose.yml启动本地中间件。GitLens查看代码提交历史、Git blame排查问题利器。注意扩展不是越多越好装多了会拖慢 VS Code 启动速度。每个扩展占用的内存和解析时间会叠加所以建议只装真正用得到的。8.3 元件的性能调优VS Code 卡顿排查VS Code 本身占用内存不大但运行 Java 语言服务器时内存会涨到几百 MB。如果项目很大建议在settings.json中限制 Java 语言服务器的堆内存java.server.launchMode: Standard, java.server.vmargs: -Xmx1024m -XX:UseParallelGC另外VS Code 的 workspace 存储目录Windows 下是%APPDATA%\Code\User\workspaceStorage里塞满了很多项目缓存时间长了会拖慢整体性能。建议定期清理这个目录让 VS Code 重新建立索引。我一般一个月清理一次清理之后明显感觉轻快不少。8.4 远程开发另一种高效工作流如果你是在公司服务器上开发或者习惯用云主机跑应用VS Code 的 Remote SSH 插件几乎是神器。本地写代码远程服务器编译运行所有依赖都装在云端本地电脑不需要高性能硬件。具体流程安装Remote - SSH扩展配置好 SSH 访问信息连接远程主机然后在远程 VS Code 窗口里打开项目。远程环境下 Java 扩展一样能用补全、调试、断点全部支持只是代码解析在云端完成。这种方式对笔记本用户尤其友好电脑温度会低很多。9. 一些操作心得和习惯建议在多次使用 VS Code 跑 Spring Boot 的过程中我总结了一些属于自己的习惯这些都是慢慢摸索出来的并不代表最优解仅供参考。第一我习惯给每个分支项目单独设置一个 VS Code 窗口。Spring Boot 项目多分支切换时同一窗口内重新加载类路径很慢而新开窗口可以让 Language Server 重新构建索引不容易出现旧编译信息干扰的问题。第二命令行启动和调试启动交替使用。日常验证代码逻辑时我更倾向直接点击运行按钮快速启动需要分析依赖、查看构建细节时切到终端执行mvn spring-boot:run -X查看 Maven 的调试输出。-X参数会输出 Maven 的完整调试日志排查依赖冲突时非常有用。第三关于断点调试我习惯在 Controller 的入口和关键业务方法各打一个断点再配合 VS Code 的变量面板查看数据变化。遇到问题时先从调用栈底部往上定位大部分 bug 都能在半小时内解决。第四是事件日志习惯。Spring Boot 的启动日志默认包含很多 debug 信息开发时不需要每次都全量输出。建议在application.yml里把logging.level设置为合适的级别比如只打印项目包名下的 INFO 日志其他第三方库保持 WARN这样日志清爽很多。说到底工具终归是工具。IDEA 很强大VS Code 很轻量谁也不必替代谁。如果你还在犹豫要不要换我的建议是先拿一个小项目试试跑通一个完整的 Spring Boot CRUD 流程你自然会有答案。