Gradle Java项目怎么发布到Maven本地仓库-java教程-PHP中文网

publishToMavenLocal无需配置URL，因Gradle内置识别逻辑：优先读取$HOME/.m2/settings.xml中配置，未配置则默认使用$HOME/.m2/repository，与Maven完全兼容。

gradle java项目怎么发布到maven本地仓库

直接执行 ./gradlew publishToMavenLocal 就能发布到本地 Maven 仓库（$HOME/.m2/repository），不需要额外配置仓库地址，也不用写 repositories { maven { ... } } 块。

为什么 `publishToMavenLocal` 不需要配置仓库 URL

Gradle 内置了对本地 Maven 仓库的识别逻辑：它会自动读取 $HOME/.m2/settings.xml 中的 <localrepository></localrepository> 配置；如果没找到，就默认使用 $HOME/.m2/repository。这个路径和 Maven 完全一致，所以其他项目（包括 Maven 项目）能直接引用你发布的包。

常见误区是以为必须像发布到远程那样写 repositories { maven { url = "file://..." } } —— 那其实是发布到**自定义目录**，不是标准本地仓库。

publishToMavenLocal 是一个独立 task，不依赖 publishing.repositories 配置
它会同时发布 JAR、POM、module 文件（如果用了 Java Platform）和可选的 sources/javadoc JAR（需显式启用）
执行后可在 ~/.m2/repository/your-group-id/your-artifact-id/ 下看到完整结构

`publishing` 块里至少要配什么才能触发 `publishToMavenLocal`

只要插件已启用且有 publication，publishToMavenLocal 就可用。最简有效配置如下：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

plugins {
    `java-library`
    `maven-publish`
}

publishing {
    publications {
        create<mavenpublication>("mavenJava") {
            from(components["java"])
            groupId = "com.example"
            artifactId = "mylib"
            version = "1.0.0"
        }
    }
}</mavenpublication>

注意点：

from(components["java"]) 必须存在，否则 publication 没内容，publishToMavenLocal 会静默跳过
groupId/artifactId/version 推荐显式声明，否则 fallback 到 project.group 等，容易出错
如果项目用了 java-library 插件但没声明 api 或 implementation 依赖，生成的 POM 可能为空依赖列表，不影响发布但可能误导使用者

发布后别人引用不了？检查这三处

即使 publishToMavenLocal 执行成功，下游项目仍可能报 Could not find com.example:mylib:1.0.0：

下游 Gradle 项目没在 settings.gradle 或 build.gradle 的 repositories 里加 mavenLocal()
下游项目用了 compileOnly 或 annotationProcessor 引入该库，但你的 publication 没包含 sources/javadoc（虽不影响运行，但 IDE 可能无法跳转）
本地仓库路径被覆盖：比如系统里存在 /etc/maven/settings.xml 或 M2_HOME/conf/settings.xml，且指定了不同 <localrepository></localrepository>，Gradle 会优先用它 —— 可用 ./gradlew help --scan 查看实际生效路径