Java 项目 VS Code / Qoder 插件配置指南

适用场景：Spring Boot 多模块项目、基于 Git worktree 的多分支并行开发 核心原则：Pack 装一次到位，子扩展不重复安装；通用效率插件按需取舍；插件不在多，在闭环。

---

一、核心套件（2 个 Pack 即完整）

插件	说明
Extension Pack for Java	微软官方 Java 套件，装它等于安装齐下表中的 6 个 Java 成员
Spring Boot Extension Pack	Spring 官方套件，装它等于安装齐下表中的 3 个 Spring 成员

装完这两个包后，Java 编写、调试、测试、构建和 Spring 配置提示的完整流程即可打通，不需要再逐个挑选组件。

---

二、包内成员（已被包含，不要单独再装）

Java 成员

插件	作用
Language Support for Java(TM) by Red Hat	JDT LS 语言服务器：补全、跳转、重构、语法与编译诊断
Debugger for Java	断点调试、启动配置、变量查看、单步与热替换
Test Runner for Java	JUnit / TestNG 用例运行与调试
Maven for Java	执行 goal、跑生命周期、生成工程原型
Gradle for Java	Gradle 任务视图与构建执行，替代命令行 ./gradlew
Project Manager for Java	项目结构与依赖视图、classpath 管理、导出 jar

Spring 成员

插件	作用
Spring Boot Tools	application.yml/properties 补全校验、Bean 与配置项跳转、运行时信息
Spring Boot Dashboard	本地应用一键启停、查看端点与运行状态
Spring Initializr Java Support	向导式生成新的 Spring Boot 工程

---

三、推荐插件

建议新增

插件	价值
Error Lens	错误与警告直接显示在代码行尾。Java 报错信息冗长，省去反复打开 Problems 面板，收益最高
EditorConfig	读取 .editorconfig，统一缩进与换行风格，多仓库、多 worktree 场景下防止格式污染
Super Mybatis	Mapper 接口与 XML 中的 SQL 双向跳转、SQL 提示（项目使用 MyBatis 才需要）
GitLens — Git supercharged	行内 blame、文件/行历史、提交对比，侧栏自带 Worktrees 视图
Git Worktree Manager	统一列出 worktree 的分支与未提交改动，创建与删除更顺手
Solarized	配色主题（当前为 Solarized Light+），个人偏好

GitLens 与 Git Worktree Manager 功能有重叠，只想留一个就留 GitLens。

---

四、Worktree 使用规范

铁律：一个 worktree 一个独立窗口。

不要把同一仓库的多个 worktree 放进同一个 multi-root workspace。原因：

• JDT LS 会按同名 Maven 模块重复建索引，CPU 与内存显著飙升；
• 多个 worktree 的 target 输出互相干扰，跳转与补全定位错乱；
• 调试启动类可能指向错误分支的代码。

推荐做法：

1. 每个 worktree 单独一个编辑器窗口；
2. 在 GitLens 或 Git Worktree Manager 的 Worktrees 视图中创建、切换、清理；
3. 用窗口级的项目名标记区分分支，避免同名工程混淆；
4. 分支删除后及时 git worktree prune，防止残留目录干扰索引。