在 gradle 7.6 中将 `mainclassname` 替换为 `mainclass.set()` 后出现“could not get unknown property 'mainclass'”错误，通常是因 gradle wrapper 版本过低（低于 6.4）导致 api 不可用，需统一并升级 wrapper 版本。
Gradle 自 6.4 版本起引入了基于 Property
✅ 正确配置示例（适用于 Gradle ≥ 6.4）：
plugins {
id 'application'
id 'java'
}
application {
mainClass.set('com.example.HelloWorld') // 注意：类名必须是全限定名（含包路径）
}⚠️ 关键检查与修复步骤：
-
确认实际运行的 Gradle 版本
运行以下命令，检查 Wrapper 使用的版本：./gradlew --version
若输出版本
Java注释规范Skills下载当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
-
升级 Gradle Wrapper 至 7.6
在项目根目录执行（需先确保本地 gradle 命令可用）：./gradlew wrapper --gradle-version 7.6
执行后，gradle/wrapper/gradle-wrapper.properties 中的 distributionUrl 将自动更新为 https\://services.gradle.org/distributions/gradle-7.6-bin.zip。
-
临时回退兼容（仅调试用）
若升级 Wrapper 前需快速验证构建，可暂时恢复旧语法（Gradle 7.6 仍兼容，但会打印弃用警告）：application { mainClassName = 'com.example.HelloWorld' // 兼容写法，非推荐长期使用 }
? 补充说明：
- mainClass.set() 是 RegularFileProperty 类型的 Property
，支持延迟求值（如 mainClass.set(project.provider { 'com.example.' + project.name })），更符合 Gradle 的惰性配置理念； - 类名务必使用完整包路径（如 com.example.App），不可省略包名或使用相对路径；
- 若使用 Kotlin DSL（build.gradle.kts），应写作 application.mainClass.set("com.example.App")。
完成 Wrapper 升级并清理缓存后，执行 ./gradlew clean build 即可正常构建。建议团队统一通过 Wrapper 管理 Gradle 版本，避免环境不一致引发的隐性问题。
