将 Java 库发布到 Maven 仓库

本教程旨在演示如何使用 IntelliJ IDEA 将在 Gradle 项目中创建的 Java 库发布到本地 Maven 仓库，然后发布到远程 Maven 仓库。

让我们从创建一个 Gradle 项目开始。

在 IntelliJ IDEA 主屏幕上，选择新建 | 项目。
如果起点是已在 IntelliJ IDEA 中打开的项目，请在主菜单中转到文件 | 新建 | 项目。
在打开的页面上，从左侧的选项列表中选择 Java。输入项目名称。在本例中为 gradle-publish ，选择 Gradle ，将其余选项保留为默认值，然后点击创建。
IntelliJ IDEA 创建一个 Gradle 项目并启用 Gradle 工具窗口。

现在让我们稍微调整一下 build.gradle.kts 文件，因为我们需要添加对 Java 库的支持并构建我们的项目。

在项目工具窗口中，点击 build.gradle.kts 文件两次以在编辑器中打开它。
此时 build.gradle.kts 包含以下代码：
plugins { id("java") } group = "org.example" version = "1.0-SNAPSHOT" repositories { mavenCentral() } dependencies { testImplementation(platform("org.junit:junit-bom:6.0.0")) testImplementation("org.junit.jupiter:junit-jupiter") testRuntimeOnly("org.junit.platform:junit-platform-launcher") } tasks.test { useJUnitPlatform() }
在 plugins 部分，将 "java" 更改为 "java-library"。
plugins { id("java-library") } group = "org.example" version = "1.0-SNAPSHOT" repositories { mavenCentral() } dependencies { testImplementation(platform("org.junit:junit-bom:6.0.0")) testImplementation("org.junit.jupiter:junit-jupiter") testRuntimeOnly("org.junit.platform:junit-platform-launcher") } tasks.test { useJUnitPlatform() }
在编辑器中点击 (同步 Gradle 更改) 以将更改同步到项目。
请使用 src/main/java 目录为您的库添加代码。
现在在 Gradle 工具窗口中，点击项目节点，点击任务，然后构建。
在打开的列表中，双击构建来执行生成我们 .jar 文件的构建任务。
因此，我们在项目工具窗口中的 build/libs 目录下生成了一个 .jar 文件。

现在，让我们遵循 Maven 约定并为库指定 Maven 坐标。由于 IntelliJ IDEA 在创建项目时已经添加了 GroupId 和 版本 ，我们唯一需要更改的是 ArtifactId。

在项目工具窗口中，点击 settings.gradle.kts 文件两次以在编辑器中打开它。将 rootProject.name 从 gradle-publish 更改为 my-artifact-id。
rootProject.name = "my-artifact-id"
点击同步 Gradle 更改以同步更改。
在 Gradle 工具窗口中，点击任务。
先在构建目录中双击清理任务以执行它，然后执行构建任务。
IntelliJ IDEA 将生成一个 .jar 文件，其中包含符合 Maven 命名约定且已更新的 artifact 名称的信息。

现在，让我们继续处理构建脚本，并将库发布到本地 Maven 仓库。

打开 build.gradle.kts 文件并将 id("maven-publish") 添加到 plugins 部分。
点击 (同步 Gradle 更改) 以将更改同步到项目。
在 Gradle 工具窗口的 publishing 部分中，点击 publishToMavenLocal 两次以运行任务。
IntelliJ IDEA 会创建一个 JAR 文件，并根据操作系统将其添加到以下目录：
/Users/<user_name>/.m2/[Artifact GroupID]/[Artifact Name]/[Artifact Version]
/home/<user_name>/.m2/[Artifact GroupID]/[Artifact Name]/[Artifact Version]
C:\Users\<User_Name>\.m2\[Artifact GroupID]\[Artifact Name]\[Artifact Version]

我们可以进一步编辑 build.gradle 文件，以将我们的库发布到远程存储库。

在 build.gradle.kts 文件中添加以下部分：
publishing { publications { create<MavenPublication>("myLib") { from(components["java"]) } } repositories { maven { name = "MyRepo" // optional target repository name url = uri("http://my.org.server/repo/url") credentials { username = "alice" password = "my-password" } } } }
点击 (同步 Gradle 更改) 以将更改加载到项目中。
在 Gradle 工具窗口中，打开 publishing 部分并点击 publishAllPublicationsToMyRepository 两次以运行任务。

有关自定义 POM 文件、使用不同的快照或发布仓库的更多信息，请参阅 Gradle 文档。

2026年 11月 3日