4.3 Java 工位整备

4.3 Java 工位整备

本节摘要：Java 是整备量最大的语种，解法是扩展全家桶：语言支持、调试、构建工具、注解处理器一站配齐。本节讲全家桶的成员分工、运行时识别、构建工具面板与测试集成，重点处理大仓库首次索引的等待心理与依赖解析的坑。整备完的 Java 工位，编译、重构、调试全程不碰外部构建命令。

从 Python 的四层栈到 Node.js 的"免整备"，再走到 Java，画风突变：这是间重装备车间。Java 的语言复杂度、构建体系、注解生态决定了它需要的装备件数最多——好在官方提供了全家桶式的扩展包，一次安装配齐主力装备。这一节按通式走，但重心放在 Java 特有的两件事上：全家桶的成员协作，以及"大仓库首次索引"这段必经的等待。

全家桶：一次安装，五件到位

Java 扩展包（官方出品）把主力装备打成一个包：语言支持（核心，负责补全、诊断、重构）、调试器、构建工具集成（主流构建系统的项目导入与任务）、测试集成、以及针对常见框架注解的处理器支持。装一个包，五件装备进位。拆开看各自的分工：

• 语言支持：重型装备，启动时解析项目结构、拉起语言服务、建索引——补全、跳转、诊断、重命名的动力源；
• 调试器：标准会话制，与 2.4 节的档位体系无缝衔接；
• 构建工具集成：识别项目的构建文件，依赖树、生命周期任务进侧栏面板；
• 测试集成：测试类旁的运行标记加侧栏测试树，与 Python 整备的测试面板同款体验；
• 注解处理器支持：让依赖注入、映射类注解的生成代码对语言服务可见——缺了它，注解标注的类满屏"找不到符号"。

运行时识别与项目导入

Java 工位开张的第一件事是确认运行时：语言支持需要知道项目编译针对的运行时版本。装好后打开项目，扩展自动识别构建文件并开始导入——下载依赖、建索引、解析模块关系。这段首次导入可能长达数分钟到更久，取决于仓库体量与依赖多寡，期间补全与诊断逐步到位，属于正常的"车间预热"。判断预热是否完成的标志：状态栏的语言状态不再转圈、大纲树完整出现。此后日常打开走增量更新，秒级。

导入环节的两个常见坑，都值得提前打预防针。其一，多模块项目的模块识别：构建文件里声明的模块没有全部被识别时，先触发一次"清理工作区并重新导入"（命令面板里的标准命令），多数识别问题一刷即愈。其二，运行时版本不匹配：项目要求的版本高于本机安装的版本时，编译诊断全区飘红，但报错内容与真实问题无关——先核版本，再看报错。

{
  "java.configuration.updateBuildConfiguration": "automatic",
  "java.compile.nullAnalysis.mode": "automatic",
  "java.format.settings.profile": "GoogleStyle",
  "editor.inlayHints.enabled": "offUnlessPressed"
}
​

这份配置调整四件事：构建文件变更后自动更新工作区（省手动刷新）；空值分析自动化；格式化走标准风格档案（与第 2 章的排版纪律衔接）；内联提示按需显示——Java 的推断信息很密，常开容易满屏吵，按住修饰键再看是更稳的档位。

构建与测试的编辑器入口

构建工具面板把依赖树与生命周期任务可视化：依赖冲突在树里直接可见（同一构件多版本并存时一眼定位）；生命周期任务点击即跑，输出进编辑器终端。测试集成让"跑一个用例、跑一个类、带覆盖率跑全部"都成为侧栏树上的点击动作。Java 工位的特色在于这些入口与语言服务深度耦合：跑测试前先自动编译、依赖变更后自动刷新导入——工序间的衔接由装备自己完成，人只管发起。

台面实测：一次跨模块重构

Java 重构的可靠性是这套重装备的回报时刻。在某多模块仓库里，把一个基础库里的公共类改名：触发重命名，语言服务先做全域影响分析，列出受影响模块与引用点，确认后一次改齐——包括调用方、测试代码、配置文件里的引用。改完触发构建任务，全仓编译通过，测试树全绿。同样的操作在轻装备工位里要靠全局搜索加逐处手改，多模块场景下漏改几乎必然。重装备的意义就是在这种时刻兜底。

坑点提醒

坑一，索引未完成就开发。 预热期内的补全缺失、诊断误报会误导判断；等状态栏就绪再动手，急不得。坑二，注解生成代码不可见。 依赖注入容器的注解满屏报错时，先查注解处理器支持是否到位，别去改业务代码。坑三，内存吃紧。 大仓库加全家桶对内存要求不低，机器偏旧时适当调高运行时内存参数，或按工作区启停重装备（第 6 章的分级启用在 Java 工位收益最大）。

常见疑问快答

问：首次导入要等多久才算异常？答：经验分界是：依赖能正常下载的仓库，等待与仓库体量成正比，进度感是持续有日志输出；卡在同一个步骤几分钟无输出、或反复报同一类解析错误，才算异常——前者耐心，后者触发“清理工作区重新导入”。

问：注解满天飞的项目，补全总慢半拍，正常吗？答：注解处理链深的项目，语言服务的分析成本天然更高，半拍延迟属正常档位。优化方向不是换装备，而是减负：确认生成源码目录进了排除清单（别让分析器反复扫生成物），再配合 6.3 节的内存调优。

问：全家桶之外还需要单独装什么吗？答：看项目用不用特殊技术栈：重度用某框架的补它的语言支持件，用代码简化注解的补对应处理器支持件。全家桶覆盖的是“标准 Java 工程”的骨架，特殊件按项目需求点缀——这仍是第 1 章按需采购原则的执行。

问：全家桶更新后行为突变，先查什么？答：先看更新说明里的兼容性条目——大版本的扩展更新常伴随默认行为调整；再把项目导入一遍（清理工作区重新导入）排除索引陈旧。两者都排除后才轮到查自己的配置，顺序反了会白忙。

替代方案

Java 的传统重型替代是老牌全功能 IDE（功能厚度仍居首），编辑器路线胜在轻快与跨语种统一；折中方案是命令行构建加编辑器纯编辑，适合只改几行的场景。选择的关键变量是仓库体量与交互频率：日常深度开发选重工具，偶尔参与选轻工位。下一节的 Go 又是另一种气质：工具链极简，装备围绕一个语言服务器运转。