Kotlin插件仅提供语言支持,Android开发需Android Studio或IDEA Ultimate启用Android插件,并确保JDK 17+、Android SDK、Gradle与AGP版本严格协同,缺一不可。

Kotlin插件在 IntelliJ IDEA 2025.2 及之后版本中已默认内置,无需手动安装;Android 开发环境的关键瓶颈不在插件,而在 JDK、Android SDK 和 Gradle 的版本协同。
为什么装了 Kotlin 插件还是写不了 Android 代码?
常见现象是新建项目时看不到 Android 模板,或创建后 build.gradle.kts 报红、Activity 类无法解析。这不是 Kotlin 插件没装好,而是 Android 开发依赖链没对齐:
- IntelliJ IDEA Community 版不带 Android 支持 —— 必须用
Android Studio(它本质是定制版 IDEA),或在 IDEA Ultimate 中手动启用Android插件 - Kotlin 插件本身只负责语言支持,
Android功能由独立插件提供:插件名是Android,不是Kotlin - 即使插件启用,若
JDK版本低于 17(Android Gradle Plugin 8.4+ 强制要求),gradle sync会直接失败,报错类似:Unsupported Java version: 11
Android Studio 与 IntelliJ IDEA 的插件启用差异
如果你坚持用 IntelliJ IDEA(比如同时开发后端 Spring Boot + Android 模块),必须确认三件事:
- 打开
Settings → Plugins,搜索并勾选Android插件(状态为Enabled)—— 注意不是Kotlin,也不是Gradle - 确保已安装
Android SDK:路径需在Settings → Appearance & Behavior → System Settings → Android SDK中可见;若为空,点Edit手动指定ANDROID_HOME目录(如/Users/xxx/Library/Android/sdk) -
Android SDK Build-Tools版本不能太新:AGP 8.4 对应推荐Build-Tools 34.0.0,但某些35.x版本会导致adb启动失败,建议从 SDK Manager 中卸载最新版,回退到34.0.0
Gradle 和 Kotlin 版本匹配表(2026 年实测有效)
很多人卡在 Could not resolve org.jetbrains.kotlin:kotlin-stdlib-jdk8 或 Plugin [id: 'com.android.application'] was not found,本质是版本错配。当前(2026 年 8 月)稳定组合如下:
-
Android Gradle Plugin (AGP)8.4.x → 要求Gradle8.6+,且kotlinVersion必须设为1.9.24(不是2.0.x) -
AGP8.5.x(预发布)→ 要求Gradle8.7,Kotlin插件用2.0.0,但androidApplication模块中仍需显式声明implementation(kotlin("stdlib")) - 千万别在
build.gradle.kts里写kotlin("stdlib-jdk8")—— JDK 17+ 下应统一用kotlin("stdlib"),否则编译时找不到符号
最容易被忽略的调试入口点
新建 Android 项目后,第一行代码往往不是 main(),而是 onCreate()。但很多开发者直接运行发现模拟器黑屏或闪退,原因常藏在细节里:
-
AndroidManifest.xml中的android:name=".MainActivity"必须与实际类名、包路径完全一致,大小写敏感,且MainActivity必须继承AppCompatActivity - 资源文件夹命名必须小写:
res/layout/activity_main.xml,写成Res/Layout或layout_main.xml都会导致R.java不生成 - 模拟器启动前,务必检查
AVD Manager中系统镜像是否已下载完成(状态栏显示Downloaded),未完成时点击运行只会弹出空白窗口
真正卡住人的从来不是“怎么装”,而是“哪个组件在静默拒绝协作”。Kotlin 插件只是语法高亮和编译器前端,而 Android 构建流程是一条由 AGP、Gradle、JDK、SDK Tools 共同咬合的传动链——断一环,全不动。


















