Gradle怎么创建Kotlin JVM项目

秋浩同学_6302

秋浩同学_6302

2026-11-04

544人浏览

原创

gradle init --type kotlin-library --dsl kotlin可直接创建Kotlin DSL项目,自动生成build.gradle.kts、标准目录结构及kotlin-jvm插件配置,无需手动编写脚本或指定版本。

gradle怎么创建kotlin jvm项目

直接用 gradle init 就能创建出可立即编译运行的 Kotlin JVM 项目,不需要手动写 build.gradle 或配置插件版本——但默认生成的脚本是 Groovy 的,想用 Kotlin DSL 得额外指定或手动转换。

用 gradle init 创建基础 Kotlin JVM 项目

在空目录下执行:

gradle init --type kotlin-library

它会生成一个带 src/main/kotlin 和 src/test/kotlin 的结构,并自动启用 org.jetbrains.kotlin.jvm 插件、添加 kotlin-stdlib 依赖、设置 jvmTarget。关键点:

  • --type kotlin-library 是最稳妥的选择;--type kotlin-application 也可用,但会多加 application 插件和 main 入口,适合需要打包成 jar 运行的场景
  • 生成的 build.gradle 默认是 Groovy 格式;若想一步生成 Kotlin DSL(即 build.gradle.kts),得加 --dsl kotlin 参数,但要注意 Gradle 7.0+ 才稳定支持
  • 生成过程会提示选择 Kotlin 版本,建议选最新稳定版(如 1.9.20),避免与 kotlin-stdlib 版本不一致导致 NoClassDefFoundError

为什么 sourceSets 不用手动配

Gradle 6.0+ 对 Kotlin JVM 项目做了开箱即用的源码路径约定:src/main/kotlin 和 src/test/kotlin 会被自动识别为 Kotlin 源集,无需在 sourceSets 里显式声明 kotlin.srcDirs。但如果你混用 Java 和 Kotlin,或者把 Kotlin 文件放在非标准路径(比如 src/main/java),就必须手动配置,否则 javac 会跳过 Kotlin 文件,kotlinc 也看不到 Java 类。

  • 只用 Kotlin?不用动 sourceSets
  • Java + Kotlin 混合?必须加 sourceSets.main.java.srcDirs = ["src/main/java"] 和 sourceSets.main.kotlin.srcDirs = ["src/main/kotlin"]
  • IDE(如 IntelliJ)有时会缓存旧路径,改完后要 reload project,否则代码补全可能失效

kotlinOptions.jvmTarget 必须和 compileOptions 对齐

哪怕只写 Kotlin,也要检查这两处是否一致,否则编译通过、运行时报 IncompatibleClassChangeError 或 UnsupportedClassVersionError:

  • kotlinOptions { jvmTarget = "11" }(Kotlin 编译目标字节码版本)
  • compileOptions { sourceCompatibility = JavaVersion.VERSION_11; targetCompatibility = JavaVersion.VERSION_11 }(Java 编译目标)
  • 如果项目用了 Spring Boot 等框架,还得看其最低要求:Spring Boot 3.x 要求 jvmTarget = "17",硬设成 "11" 会导致运行时找不到 java.lang.Record 等类

运行 Kotlin 主函数的坑:mainClassName 不是类名

Kotlin 文件里的顶层 fun main() 编译后对应的是 FileNameKt.class,不是 FileName.class。所以用 application 插件时,mainClass.set("AppKt") 才对,写成 "App" 会报 Could not find or load main class App。

  • 确认方式:运行 ./gradlew classes 后,在 build/classes/kotlin/main/ 下看生成的 class 文件名
  • 如果用的是 fun main(args: Array) 且文件叫 App.kt,主类就是 AppKt
  • IntelliJ 运行配置默认能识别,但命令行或 CI 中必须显式写对,否则构建产物无法启动

最易被忽略的是 jvmTarget 和框架基线的匹配,以及 mainClassName 的 Kt 后缀——这两个点不检查,项目看起来能编译,一运行就断在最前端。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
Kotlin协程编程与Spring Boot集成实践
Kotlin协程编程与Spring Boot集成实践

本专题围绕 Kotlin 协程机制展开,深入讲解挂起函数、协程作用域、结构化并发与异常处理机制,并结合 Spring Boot 展示协程在后端开发中的实际应用。内容涵盖异步接口设计、数据库调用优化、线程资源管理以及性能调优策略,帮助开发者构建更加简洁高效的 Kotlin 后端服务架构。

2026.02.12

391

18

Java Kotlin协程与异步编程实战
Java Kotlin协程与异步编程实战

本专题围绕 Kotlin 协程与异步编程展开,讲解挂起函数、协程作用域、异步任务调度及并发控制方法。通过实际项目案例,帮助开发者提升后端服务性能,实现高效异步任务处理与稳定性保障。

2026.04.13

179

16

Kotlin Android开发教程大全
Kotlin Android开发教程大全

系统讲解 Google 官方推荐的 Android 开发首选语言 Kotlin 的核心知识与工程实践,涵盖 Kotlin 简洁语法(空安全/数据类/扩展函数/解构声明/作用域函数)与 Java 互操作、集合操作与函数式编程、协程(Coroutines)异步编程(suspend/launch/async/Flow)、Jetpack Compose 声明式 UI 开发(状态管理/组合函数/导航/动画)、MVVM / MVI 架构设计与 Vi

2026.06.03

288

19

Tailwind CSS 如何制作导航栏和卡片
Tailwind CSS 如何制作导航栏和卡片

用 Tailwind CSS 制作导航栏和卡片,可先搭建语义化结构,再组合 Flex、Grid、间距、圆角与阴影类。这里整理横向导航、移动端菜单、卡片网格及悬停效果的相关文章,帮助你把常见页面组件做得清晰且适配不同屏幕。

2026.11.03

0

17

Tailwind CSS 响应式布局怎么写
Tailwind CSS 响应式布局怎么写

Tailwind CSS 响应式布局通常从移动端样式写起,再用 sm、md、lg 等前缀调整不同屏幕宽度下的网格、间距和导航。本专题整理断点配置、Grid 与 Flex 自适应布局及常见溢出问题,帮助你逐步完成多设备适配。

2026.11.03

0

19

Tailwind CSS 常用类名怎么记
Tailwind CSS 常用类名怎么记

Tailwind CSS 类名很多,先按布局、间距、文字、颜色和状态分组记忆,再通过官方文档检索具体写法。本专题结合类名排序、动态拼接失效、自定义实用类等问题,帮助你建立常用类名的速查方法。

2026.11.03

0

12

码上飞入口地址合集
码上飞入口地址合集

本专题汇总了码上飞(CodeFlying)的官方入口地址合集,涵盖官网主站及网页版在线使用入口,支持注册登录后直接在线体验零代码AI应用生成。同时整理了APP端下载渠道与小程序入口,助你快速访问平台,通过自然语言描述需求即可生成应用、小程序或网站。

2026.11.03

0

10

Uvicorn 报错与问题解决教程
Uvicorn 报错与问题解决教程

本专题汇总了Uvicorn服务器常见问题与报错解决的教程合集,涵盖启动失败、端口占用、模块导入错误、事件循环冲突及热重载失效等典型故障的排查思路。同时整理了多进程与Worker配置、SSL/HTTPS证书报错、跨域与代理配置等实战解决方案,助你快速定位并解决Uvicorn运行中的各类问题。

2026.11.02

20

14

Uvicorn使用教程
Uvicorn使用教程

本专题汇总了Uvicorn使用教程与启动运行指南,涵盖其作为Python ASGI服务器的定位与特点,以及命令行启动(uvicorn main:app --reload)、参数配置(host/port/workers)、程序内嵌运行与Gunicorn结合部署等核心用法。同时整理了热重载调试、日志配置与生产环境部署优化等技巧,助你快速掌握Uvicorn的运行与配置。

2026.11.02

20

17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gradle 9 主版本升级指南
Gradle 9 主版本升级指南

共0课时 | 0人学习

Gradle 安全最佳实践
Gradle 安全最佳实践

共0课时 | 0人学习

Gradle 依赖校验手册
Gradle 依赖校验手册

共0课时 | 0人学习