如何在IntelliJ中调试基于Groovy的Gradle插件并步进其源代码

前置配置：插件发布侧调整 #

• 在你的自定义插件项目的build.gradle中添加源码打包配置，确保发布到Nexus时同步上传源码包：

java {
    // 开启源码打包
    withSourcesJar()
    // 可选：开启Javadoc打包
    withJavadocJar()
}

publishing {
    publications {
        maven(MavenPublication) {
            from components.java
            // withSourcesJar会自动将源码包加入发布制品，无需额外配置
        }
    }
    repositories {
        maven {
            // 替换为你的Nexus仓库地址
            url = "https://your-nexus-repo.com/repository/maven-releases/"
            credentials {
                username = project.findProperty("nexusUsername")
                password = project.findProperty("nexusPassword")
            }
        }
    }
}

• 执行publish任务重新发布插件到Nexus，确认对应版本的插件制品下同时存在.jar（二进制包）、-sources.jar（源码包）两个文件。

使用插件的项目侧配置 #

• 开启IntelliJ Gradle自动下载源码开关：打开File > Settings > Build, Execution, Deployment > Build Tools > Gradle，在Automatically download区域勾选Sources，保存后点击Gradle侧边栏的刷新按钮重新同步项目，IntelliJ会自动从Nexus拉取插件的源码包关联。
• 若自动关联失效，可手动绑定源码：调试时步进到反编译的插件class文件后，点击编辑器顶部的Choose Sources按钮，选择本地插件项目的src/main/groovy源码目录，或者从本地Maven/gradle缓存中选择对应版本的-sources.jar包即可完成关联。

本地调试优化方案 #

如果插件项目和使用插件的项目都在本地开发环境中，可以直接通过模块依赖跳过Nexus发布环节：

• 打开File > Project Structure > Modules > 选中使用插件的项目 > Dependencies，点击+号选择Module Dependency，选中本地的插件项目模块，保存后调试会直接关联本地最新源码，无需每次修改都重新发布到Nexus。

注意：需保证插件的本地源码版本、发布到Nexus的版本、使用项目依赖的插件版本三者完全一致，避免出现源码和运行字节码行数不匹配的错位问题。

内容的提问来源于stack exchange，提问作者SMUsamaShah