Gradle init --type java-application 可直接生成可运行Java项目，自动配置application插件、mavenCentral仓库及mainClass，避免手写build.gradle遗漏关键配置；执行前需确保空目录、Gradle已安装、网络通畅且JDK版本匹配。
直接用 gradle init --type java-application 就能生成可运行的 Java 项目，不需要手动建目录、写 build.gradle 或配 src 结构——这是 Gradle 官方推荐的起点，也是最不容易出错的方式。
为什么不用手动写 build.gradle？
手写容易漏掉关键插件或约定配置，比如 application 插件没加，mainClass 就不会被识别；漏了 repositories，连 junit 都拉不下来。而 gradle init 自动生成的文件已包含：
-
plugins { id 'java'; id 'application' }—— 同时支持编译和运行 -
repositories { mavenCentral() }—— 默认开箱即用的依赖源 -
application.mainClass = "App"—— 自动指向src/main/java/App.java
执行 gradle init 前要确认什么？
不是所有环境都能直接跑成功，常见卡点在这几个地方：
- 确保终端在空目录下执行，否则
gradle init会报Project directory is not empty - 检查
gradle -v能否输出版本，如果提示 command not found，说明没配好PATH或没安装 Gradle - 如果网络受限，
mavenCentral()拉包失败，需要在生成后手动把repositories块改成公司私服或阿里云镜像 - Java 版本不匹配会导致编译失败，
gradle init默认用当前JAVA_HOME的 JDK，但生成的build.gradle里没锁死sourceCompatibility，建议立即补上：java { sourceCompatibility = JavaVersion.VERSION_17 targetCompatibility = JavaVersion.VERSION_17 }
生成后第一件事：别急着 run，先验证结构
生成完立刻检查三处，避免后续白忙活：
-
src/main/java/App.java是否存在且含public static void main—— 这是application插件找入口的依据 -
build.gradle里是否有application.mainClass = "App"（Groovy DSL）或application { mainClass.set("App") }（Kotlin DSL） - 执行
./gradlew tasks，看输出里有没有run和build任务 —— 没有说明插件没生效或配置被覆盖
最容易被忽略的是：gradle init 生成的项目默认不带 test 依赖的版本号（比如 junit），如果后续要写测试，得自己往 dependencies 里补全 testImplementation 'junit:junit:4.13.2' 或更高版本，否则 ./gradlew test 会直接失败。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
