如何从Android Studio的Java项目中彻底移除Kotlin？

云上老周

2026-7-11

从Android Java项目中移除Kotlin的完整方案

一、从已有Java项目中删除Kotlin

删除项目中所有.kt、.kts后缀的文件，包括Kotlin DSL格式的构建脚本（如果原本用的是Groovy构建脚本，直接保留.gradle文件即可）。
打开项目根目录的build.gradle文件，移除Kotlin插件的classpath依赖，比如删掉这一行：
```
classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:x.x.x"
```
打开模块目录（通常是app）的build.gradle文件：
- 移除Kotlin相关插件声明，比如apply plugin: 'kotlin-android'、apply plugin: 'kotlin-android-extensions'这类行；
- 移除dependencies块中所有Kotlin相关依赖，比如implementation "org.jetbrains.kotlin:kotlin-stdlib:x.x.x"。
执行清理操作：点击File -> Invalidate Caches...，选择Invalidate and Restart；重启后执行Build -> Clean Project，再执行Build -> Rebuild Project。

二、新Java项目移除隐性引入的Kotlin库

如果Gradle里没加Kotlin依赖但产物仍包含Kotlin库，大概率是第三方依赖间接引入，或者Android Studio默认的隐性配置导致，按以下步骤处理：

先确认模块级build.gradle中没有任何Kotlin相关配置：包括插件声明、dependencies里的Kotlin依赖、android块中的kotlinOptions等，全部删除。

排查间接依赖：在终端执行命令查看依赖树：

# Mac/Linux
./gradlew app:dependencies
# Windows
gradlew.bat app:dependencies

找到引入Kotlin库的第三方依赖，在该依赖中添加排除规则，比如：

implementation('com.example:some-third-party-lib:1.0.0') {
    exclude group: 'org.jetbrains.kotlin'
}

若不想逐个排查，可全局排除所有Kotlin依赖，在模块级build.gradle的dependencies块上方添加：

configurations.all {
    exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib'
    exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib-jdk7'
    exclude group: 'org.jetbrains.kotlin', module: 'kotlin-stdlib-jdk8'
    exclude group: 'org.jetbrains.kotlin', module: 'kotlin-reflect'
}