no-arg插件必须配合自定义注解使用，它不会自动为所有data class生成无参构造器；需先定义注解（如@NoArg）、在build.gradle中注册该注解路径，且必须显式apply plugin并正确配置noArg块，否则无效。
no-arg插件必须配合自定义注解使用
no-arg插件不会自动为所有data class生成无参构造器，它只响应你明确指定的注解。如果你直接加@NoArg却没在build.gradle里注册这个注解路径，编译时完全没效果，也不会报错——这是最常被忽略的前提。
你需要先定义一个注解类，比如：
@Target(AnnotationTarget.CLASS) @Retention(AnnotationRetention.BINARY) annotation class NoArg
然后在构建脚本中告诉插件：“看到这个注解就生成无参构造”。Groovy DSL写法是：
noArg {
annotation("com.example.NoArg")
}
Kotlin DSL（build.gradle.kts）则写成：
noArg {
annotation("com.example.NoArg")
}
- 注解包名必须和实际路径完全一致，大小写、斜杠方向都不能错
- 注解的
@Retention建议用BINARY或RUNTIME，SOURCE会导致插件扫描不到 - 不要把注解定义在
main源码集之外（比如test目录），否则插件在主编译阶段找不到它
Gradle 8.x + Kotlin DSL 的正确启用方式
新版 Gradle 推荐用plugins块声明插件，但org.jetbrains.kotlin.plugin.noarg不能直接用id方式启用——它不支持pluginManagement里的版本锁定，必须走传统apply plugin流程。
在子模块的build.gradle.kts中，按顺序做三件事：
- 确保
kotlin("jvm")已应用（no-arg 是 Kotlin 编译器插件，依赖 Kotlin 插件） - 用
apply(plugin = "kotlin-noarg")显式启用 - 紧接着配置
noArg { ... }闭包
完整示例：
plugins {
kotlin("jvm") version "1.9.24" // 与 no-arg 版本对齐
}
apply(plugin = "kotlin-noarg")
noArg {
annotation("com.example.NoArg")
}
如果跳过apply(plugin = ...)这一步，即使写了noArg块，插件也不会生效。
Spring 或 JPA 项目优先用封装好的插件
如果你用的是 Spring Boot，别手动配no-arg——直接用kotlin-spring，它内部已集成no-arg和allopen逻辑，并预置了@Configuration@Service@RestController等常见注解的处理规则。
同理，JPA 场景下用kotlin-jpa更省事，它会自动为@Entity@Embeddable标注的类生成无参构造器，无需额外定义注解或配置noArg块。
启用方式（Kotlin DSL）：
plugins {
kotlin("plugin.spring") version "1.9.24"
// 或
kotlin("plugin.jpa") version "1.9.24"
}
这两个插件本质是no-arg+allopen的组合封装，且做了框架语义适配，比如kotlin-spring不会给@Component以外的类开open，避免破坏封装性。
多模块项目里容易漏掉的生效范围
no-arg 插件只作用于它被应用的模块。你在根项目build.gradle.kts里配了noArg { ... }，但没在子模块中apply plugin，那子模块的类根本不会被处理。
推荐做法是：在根项目统一声明插件依赖，在每个需要它的子模块中单独启用并配置。例如：
// 根项目 settings.gradle.kts
pluginManagement {
plugins {
id("org.jetbrains.kotlin.plugin.noarg") version "1.9.24"
}
}
// 子模块 build.gradle.kts
apply(plugin = "kotlin-noarg")
noArg {
annotation("com.example.NoArg")
}
注意：noArg配置不能写在根项目subprojects闭包里——它不是 Gradle 扩展，而是 Kotlin 编译器插件的 DSL，必须出现在子模块的构建脚本顶层作用域。
另外，测试代码（src/test）默认不经过主编译流程，如果测试里也要用 no-arg，得在test源码集单独配置 Kotlin 编译任务，或者把注解加到主源码里并确保测试能访问到。
