Flutter Windows 下“Running Gradle task ‘assembleDebug‘...” 卡住一整天的终极解决办法

Flutter Windows 下"Running Gradle task 'assembleDebug'..." 卡住一整天的终极解决办法（2025最新亲测有效）

最近好多小伙伴（包括我自己）在 Windows 上跑 Flutter 项目的时候，都遇到一个超级恶心的假死问题：

明明代码没改，flutter run 一下就卡在这一行，转半天小菊花：

复制代码

Running Gradle task 'assembleDebug'...

等半天不动，日志里还疯狂打印它在下载一个叫 NDK (Side by side) 27.0.12077973 的东西，1GB+，速度还只有几 KB/s！

我踩了一整天坑，终于找到了最稳定、最一劳永逸的解决方案，分享给大家，5 分钟搞定！

问题根本原因

Flutter 3.19+ + Android Studio Iguana/Hedgehog + Gradle 8.x 之后，默认会强制拉取最新的 NDK 27.x 版本，而且这个版本巨大 + Google 服务器在国内巨慢，基本等于卡死。

最推荐的解决方案（99%的人用这个就行）

步骤1：用 Android Studio 安装一个稳定小巧的 NDK 版本

打开 Android Studio → More Actions → SDK Manager
切换到 SDK Tools 标签页
勾选以下两个（必须都勾！）：
- NDK (Side by side) → 推荐勾 25.1.8937393（体积最小，最兼容！）
- CMake（顺手装上）
点击 Apply 安装，400～600MB，几分钟就下完了

步骤2：项目里强制使用你刚装的 NDK 版本（也可以省略）

打开项目下的 android/app/build.gradle 文件，在 android {} 块里加上这一行：

gradle 复制代码

android {
    compileSdk 35

    // 这一行必须加！锁死 NDK 版本，彻底杜绝自动下载 27.x
    ndkVersion "25.1.8937393"

    defaultConfig {
        applicationId "com.example.yourapp"
        minSdkVersion 21
        targetSdkVersion 35
        versionCode flutterVersionCode.toInteger()
        versionName flutterVersionName
    }

    // 其他配置...
}

步骤3：清理并重新运行

bash 复制代码

flutter clean
flutter pub get
flutter run

基本 10～30 秒就出结果了！再也不会卡那个破进度条了！

终极防坑模板（以后新建项目直接复制这几行）

gradle 复制代码

android {
    compileSdk 35
    ndkVersion "25.1.8937393"   // 锁版本，永不翻车！

    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 35
    }
}

额外小 tip

如果你项目根本没用到 C++ 原生代码（大多数纯 Flutter 项目都没用），还可以直接把 externalNativeBuild 那整段注释掉，更干净。
想用 26.x 也行，换成 "26.1.10909125" 就行，但 25.1 是目前最稳最小的。

亲测 2025 年 11 月最新版 Flutter 3.24+ + Android Studio Koala 依然完美有效！