Gradle注册buildSrc自定义任务报错：未解析引用及语法问题

错误原因梳理 #

• 文件路径与包结构不匹配：你的FilePrefTask.kt文件路径写错了，work是包名，对应实际的文件夹，正确路径应为src/main/java/work/FilePrefTask.kt，而非src/main/java/work.FilePrefTask.kt。
• Task注册语法错误：tasks.register的写法不符合Gradle Kotlin DSL规范，同时配置文件末尾多了一个多余的闭合大括号。

修正步骤 #

1. 修正目录结构 #

确保buildSrc的目录结构正确：

-buildSrc
   -src
     -main
       -java
         -work
           -FilePrefTask.kt
   -build.gradle.kts

2. 完善自定义Task代码 #

给类添加包声明，保证类能被正确识别：

package work

import org.gradle.api.DefaultTask
import org.gradle.api.tasks.TaskAction

abstract class FilePrefTask: DefaultTask() {

    @TaskAction
    fun action(){
        println("Hello world")
    }
}

3. 修正build.gradle.kts配置 #

修正Task注册语法，移除多余的闭合大括号：

repositories {
    mavenCentral()
}

plugins {
    `kotlin-dsl`
}

// 导入自定义Task类
import work.FilePrefTask

// 正确的Task注册写法，泛型已指定任务类型，无需额外传参
tasks.register<FilePrefTask>("prefTask")

也可以使用全限定类名注册，无需导入：

tasks.register<work.FilePrefTask>("prefTask")

关键说明 #

• tasks.register<FilePrefTask>("prefTask")是Gradle Kotlin DSL的标准写法，泛型已经明确了任务类型，额外传递FilePrefTask::class会触发vararg参数的语法错误。
• 包名必须与文件目录结构严格对应，否则Gradle无法找到自定义Task类，导致“Unresolved reference”错误。

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