本文详解在纯 java android 项目中禁用 kotlin 插件、清理残留依赖与配置，确保项目完全脱离 kotlin 运行时和 ide 支持。

本文详解在纯 java android 项目中禁用 kotlin 插件、清理残留依赖与配置，确保项目完全脱离 kotlin 运行时和 ide 支持。

Android Studio 自 4.2 起默认集成 Kotlin 插件，即使你创建的是「Empty Activity (Java)」项目，IDE 仍可能自动启用 Kotlin 支持（如语法高亮、快速修复提示），并在构建产物中意外引入 kotlin-stdlib 等轻量级依赖。要真正实现“零 Kotlin”，需从 IDE 层面 和 构建配置层面 双向清理。

✅ 第一步：禁用 Kotlin 插件（IDE 级别）

1. 打开 Android Studio → File → Settings（macOS：Android Studio → Preferences）
2. 导航至 Plugins
3. 在搜索框输入 Kotlin，找到官方插件 Kotlin
4. 取消勾选 → 点击 Apply → 重启 IDE

⚠️ 注意：禁用后，.kt 文件将不再被识别，Kotlin 相关代码提示、重构、错误检查全部失效；同时，新建文件菜单中将不再显示 Kotlin 类型选项。

✅ 第二步：检查并清理 Gradle 配置

尽管新建 Java 项目通常不显式声明 Kotlin 依赖，但仍建议逐项核查：

• 打开项目根目录下的 build.gradle（或 build.gradle.kts）和各模块的 build.gradle，确认无以下任一内容：

  

  Android Control

  通过命令行工具（uiautomator、screencap、input、am）控制安卓设备。优先尝试非 root 执行，失败后自动回退至 root...

  下载

  // ❌ 删除这些（如果存在）
  plugins {
      id 'org.jetbrains.kotlin.android' // 或 kotlin-android
  }
  
  dependencies {
      implementation "org.jetbrains.kotlin:kotlin-stdlib:1.9.20"
      implementation "androidx.core:core-ktx:1.12.0" // Java 项目应改用 core:1.12.0
  }

• 若使用 core-ktx，请替换为对应的 Java 版本（推荐）：

  // ✅ 替换为纯 Java 兼容版本
  implementation "androidx.core:core:1.12.0"

✅ 第三步：验证是否彻底移除

1. 执行 Build → Clean Project，再 Rebuild Project
2. 查看 app/build/outputs/apk/ 或 app/build/intermediates/ 中的 classes.dex 或 resources，使用 dexdump 或 jadx-gui 检查是否仍含 kotlin/ 包路径
3. 在终端运行：

   ./gradlew app:dependencies | grep kotlin

   输出应为空 —— 表示无 Kotlin 依赖传递引入。

? 补充说明

• 即使未添加任何 Kotlin 代码，Android Studio 的模板 Activity（如 MainActivity.java）有时会自动生成 setContentView(R.layout.activity_main) 的 Kotlin 对等提示（灰色小灯泡），该提示由 Kotlin 插件提供，禁用插件后即消失。
• androidx.appcompat:appcompat 等主流库本身不强制依赖 Kotlin，无需额外处理；但务必避免引入 *-ktx 后缀的 Kotlin 扩展库。

完成以上三步后，你的项目将回归纯粹的 Java 构建环境，构建体积更小、依赖更清晰，也更适合团队中仅熟悉 Java 的开发者协作维护。