application插件仅适用于有明确main类、无需外部容器的独立Java程序，如命令行工具或后台服务；不适用于库、Web应用、Android模块等。
application 插件只适合**有明确入口类、需要直接运行的独立 Java 应用程序**，比如命令行工具、后台服务、单机桌面程序（非 Web 容器托管）、脚本化工具等。它不适合库（java-library）、Web 应用（应配 war 或 Spring Boot 插件）、Android 模块或任何不以 public static void main(String[]) 启动的项目。
什么时候该用 application 插件？
你正在构建一个“能双击或敲命令就跑起来”的 Java 程序，且满足以下全部条件：
- 项目只有一个主类（
mainClass可唯一指定） - 不依赖外部容器（如 Tomcat、Jetty 不通过插件内建启动）
- 需要生成带启动脚本的分发包（
distZip/distTar） - 开发阶段想用
gradle run快速验证逻辑，而不是手动java -cp ...
application 和 java-library 混用会出什么问题？
常见错误现象：Could not find method application() for arguments [...] on root project 或 run 任务不存在 —— 因为 java-library 插件没提供 run，也不隐式应用 Distribution 插件。
更隐蔽的问题是：即使你手动加了 application，但项目结构仍按库约定组织（比如没有 src/main/java 下的主类），run 会找不到类；或者你误把 api/implementation 依赖写法套到 application 项目里，导致运行时缺类（NoClassDefFoundError）。
正确做法：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 纯库项目：只用
plugins { id 'java-library' }，靠jar任务输出供他人引用 - 可执行程序：只用
plugins { id 'application' }（它已隐式包含java），依赖统一用implementation - 既要发布库、又要带 demo 可执行入口？拆成两个子模块，分别用
java-library和application
mainClass 配置为什么总报错？
典型错误：Could not resolve all files for configuration ':runtimeClasspath' 或 Failed to launch JVM: No main class specified。
原因往往不是路径写错，而是：
-
mainClass = "com.example.App"中的类名必须在src/main/java下真实存在，且编译后出现在build/classes/java/main/对应路径 - 类里必须有符合签名的
public static void main(String[] args)方法（不能是static void main()或参数类型不对） - 如果用了模块系统（
module-info.java），需确保该模块导出含 main 类的包，并在mainClass后追加--module参数（Gradle 7.4+ 支持application { modules = ['com.example'] }） - 多模块项目中，
mainClass必须指向最终打包模块里的类，不能跨模块引用未发布的类
真正容易被忽略的一点：application 插件默认把所有 runtimeClasspath 依赖打进分发包，但它**不会自动处理 native 库、配置文件或资源目录的路径适配**。如果你的程序硬编码了 ./config/app.conf，那 distZip 解压后运行脚本的当前工作目录未必是你预期的——得靠 applicationDefaultJvmArgs 或自定义启动脚本修正。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
