VS Code 中的 Java 构建工具
本文档概述了如何在Visual Studio Code中使用Java构建工具。它涵盖了 Java 版 Maven 和 Java 扩展版 Gradle 以及其他工具。
如果您在使用以下功能时遇到任何问题,可以通过输入问题与我们联系。
梅文
Maven 是一款帮助你管理 Java 项目和自动化应用构建的软件工具。Visual Studio Code 的 Maven for Java 扩展提供了完全集成的 Maven 支持,允许你探索 Maven 项目、执行 Maven 命令,并执行构建生命周期和插件的目标。我们建议安装 Java 扩展包,其中包含 Maven 支持及其他重要的 Java 开发功能。
探索Maven项目
一旦加载了 Maven 项目,扩展就会被激活,并会自动扫描pom.xml文件在你的工作区中,并在侧边栏显示所有 Maven 项目及其模块。

解析未知类型
Maven 扩展还支持在 Maven Central 中搜索,以解析源代码中的未知类型。你可以通过悬停显示的“解析未知类型”链接来实现。
与POM.xml合作
该扩展提供了代码片段和自动补全功能,用于基于本地 Maven 仓库添加 Maven 依赖。看看给你的新依赖添加是多么容易pom.xml还有那些方便的功能。
该扩展还能让你生成高效的POM。
你也可以使用命令 Maven: Add a Dependency(或者maven.project.addDependency)以帮助添加新的依赖pom.xml.这个过程是互动的。
你也可以通过项目视图添加依赖,它调用的是同一个 Maven 命令。
此外,VS Code 还支持在树状视图中显示依赖,这让你可以在一个地方检查项目中的所有依赖,并检查潜在问题。
执行Maven命令和目标
通过在资源管理器中右键点击每个 Maven 项目,你可以方便地运行 Maven 目标。
扩展还保留了每个项目的目标历史,方便你快速重启之前的命令,这在运行较长的自定义目标时非常有用。
重跑进球有两种方式:
- 在命令面板中,运行 Maven: History,然后从其历史中选择一个项目和一个命令。
- 右键点击项目并选择历史。然后你可以从历史中选择之前的命令。
你还可以在设置中指定你喜欢的命令,方便未来执行。
对于你在项目中使用的每个插件,扩展还为你提供了一个轻松访问每个插件内目标的方式。
要调试 Maven 目标,右键点击目标并开始调试。Maven扩展会用正确的参数调用Java调试器。这是一个方便且节省时间的功能。
从 Maven 原型生成项目
该扩展提供的另一个实用功能是从Archetype生成Maven项目。该扩展加载本地/远程目录中列出的原型。选择后,扩展发送MVN 原型:生成 -D...去终端。
创建Maven项目有几种方式:
-
在 Maven Explorer 中,选择 + 创建 Maven 项目按钮。

-
打开命令面板(⇧⌘P(Windows,Linux Ctrl+Shift+P)),搜索“创建 Java 项目”命令。
-
右键点击目标文件夹,选择创建Maven项目。
格拉德勒
VS Code 通过 Gradle for Java 扩展支持 Gradle Java 项目(不包括 Android)。该扩展提供多个组件以提升您的 Gradle Java 项目体验:
- Gradle 构建服务器:Gradle 构建服务器用于导入 Gradle 项目并将构建任务委托给 Gradle 守护进程,确保项目输出如同从命令行运行 Gradle 任务一样一致。
- 视觉界面:允许你查看和管理Gradle任务及项目依赖,并直接在VS Code中运行Gradle任务。
- Gradle 语言服务器:为 Gradle 构建文件提供了更优质的创作体验,包括语法高亮、错误报告和自动补全。
Gradle 构建服务器
默认情况下,如果你安装了 Gradle for Java 扩展,Gradle 构建服务器会用于导入 Gradle 项目。你可以通过设置开关Gradle构建服务器java.gradle.buildServer.enabled.
你可以在Gradle构建服务器(Build)输出通道中查看Gradle构建输出,并在Gradle构建服务器(日志)输出通道中追踪VS Code与Gradle构建服务器之间的交互。
将测试委托给Gradle
该扩展支持将测试执行委托给 Gradle。你可以在测试资源管理器中配置你想使用的测试配置文件。
注意:确保你安装了Test Runner for Java扩展才能使用此功能。
处理Gradle任务
当你在VSCode中打开Gradle项目时,可以通过点击Gradle侧边栏条目找到一些有用的Gradle视图。Gradle 项目视图列出了工作区中所有的 Gradle 项目。你可以在这里查看、运行或调试Gradle任务。
当工作区中有许多Gradle任务时,可能很难找到具体的任务。该扩展提供了置顶任务视图,帮助你将喜欢的任务置顶,方便在单独视图中找到它们。你也可以在“最近任务”视图中查看最近执行的任务。
查看Gradle依赖
在 Gradle 项目视图中,你可以在每个 Gradle 项目项下找到一个依赖项。它包含了你指定配置中的所有依赖,你可以轻松检查项目的依赖状态。

管理Gradle恶魔
Gradle 守护进程视图显示当前工作区的守护进程状态。它列出了所有运行中的 Gradle 守护进程,与工作区版本相同。你可以选择在这个视图中阻止一个特定或所有恶魔。
编写构建文件
该扩展为 Gradle 构建文件提供了一些实用的创作功能。
打开 Groovy Gradle 文件时,扩展名会分析 Gradle 文件并提供语义标记信息,从而提供更精确的高亮结果。

在大纲视图中,扩展名提供了打开的Gradle文件的文档符号,帮助你轻松导航到文件的任何部分。

如果打开的 Gradle 文件中有任何语法错误(缺少字符、找不到类型等),可以在问题视图中找到。

扩展支持Gradle文件的基本自动补全,当你试图在Gradle脚本中输入Gradle闭包或属性时,扩展会建议可用的闭包或属性。
当你试图申报新的依赖时,扩展会为你提供一个依赖候选名单。
附加资源
访问 Maven 扩展的 GitHub 仓库,获取更多配置和故障排除指南。
除了 Maven,如果你用 Bazel 构建和测试项目,还有 Bazel 扩展。
下一步
继续阅读,了解更多: