如何解决Android Studio下载NDK失败

Android Studio下载NDK失败——这个问题说大不大，说小不小，但一旦碰上，C/C++代码编译不了、JNI调用直接报错、构建过程说崩就崩，项目连基本运行都成问题。其实背后的原因往往并不复杂，只不过处理起来需要一点耐心和准确的动作。下面把排查和解决的路径梳理清楚，希望能帮你一次性搞定Android Studio下载NDK失败的问题。

先确认是否真在下载NDK

很多时候，你以为Android Studio在下NDK，其实它根本没动。打开 File → Project Structure → SDK Location，看一眼右侧“Android NDK location”路径——如果是空的或者显示“Not configured”，那问题很直观。但如果路径已经填上了，项目依然报NDK相关错误，那说明NDK并没有真正安装成功，更可能的情况是下载卡住或者校验挂掉了。

另一个更直接的判断方法是：点击 Tools → SDK Manager，切换到 SDK Tools 标签页，勾选“Show Package Details”，然后展开“NDK (Side by side)”那一项。看看你勾选的版本号右边状态栏，如果长期挂着“Installing…”不动，或者突然变灰、点了没反应，那基本可以确定——Android Studio下载NDK失败了。

强制清除NDK缓存并重试

明确了是Android Studio下载NDK失败之后，不要急着反复点重试，那样很可能只会重复卡在同一个地方。正确的做法是先把残余清理干净，逼Studio重新走一遍完整的下载流程。

第一步：关掉Android Studio。

第二步：找到并删除NDK的临时下载包。Windows上路径在 %USERPROFILE%\.android\repository\ndk- 开头的所有.zip和.temp文件；macOS则是 ~/Library/Android/sdk/.android/repository/ndk- 开头的同名文件。统统删干净。

第三步：删除已经解压但可能损坏的旧版本文件。进入SDK根目录下的 ndk 文件夹（比如 D:\AndroidSdk\ndk），把里面的子文件夹全删了，只保留空的 ndk 文件夹本身。这一步很关键，不然Studio会以为NDK已经存在，直接跳过下载流程，去尝试复用那些已经损毁的旧文件。

第四步：重启Android Studio，等IDE完全加载完毕（大约十秒），再次打开SDK Manager，重新勾选NDK，点击Apply。这时候它才真正重新开始下载，解决Android Studio下载NDK失败的问题。

改用清华镜像源下载NDK

如果你所在的网络环境访问Google服务不太顺畅，那不妨直接切换镜像源。这不丢人，算是国内开发者的常规操作，也能有效避免Android Studio下载NDK失败。

推荐第一个方法：通过SDK Manager界面配置。操作路径是 Tools → SDK Manager → SDK Update Sites 标签页，点击右上角的“+”，Name填“TUNA-NDK”，URL填 https://mirrors.tuna.tsinghua.edu.cn/android/repository/，确认后勾选这个条目，点击Apply即可。

如果觉得UI方式可能还是不够稳定，可以选择手动修改仓库配置文件。具体操作：关闭Android Studio，找到 %USERPROFILE%\.android\repositories.cfg（Windows）或 ~/.android/repositories.cfg（macOS），在文件末尾另起一行，粘贴上面那个镜像地址，保存，重启Android Studio。

有一点需要特别注意：NDK不走独立的镜像通道，它复用Android SDK的主镜像源地址。所以URL结尾一定要是 .../repository/，而不是 .../ndk/。填错了，完全无效，Android Studio下载NDK依然会失败。

手动下载NDK并本地导入

如果上面几步都试了还是不顺，最后的策略就是手动下载然后本地导入，最干脆，也最没有不确定性，彻底根除Android Studio下载NDK失败的问题。

（1）访问清华镜像站的NDK目录：https://mirrors.tuna.tsinghua.edu.cn/android/repository/。

（2）在页面中找到对应的压缩包。Windows系统找类似 android-ndk-r25b-windows.zip，macOS找 android-ndk-r25b-darwin.zip。版本号要和你在SDK Manager里勾选的一致——比如r25b对应的是25.1.x这一批版本。

（3）下载完成后，把它解压到任意纯英文路径。建议放在一个结构清晰的目录下，例如 D:\AndroidSdk\ndk\25.1.8937393。

（4）回到Android Studio，依次进入 File → Project Structure → SDK Location，点击“Android NDK location”右侧的Edit按钮，浏览并选中刚才解压出来的那个完整版本文件夹（注意是文件夹，里面要包含 build、platforms 等子目录），点击OK确认。

到这一步，NDK算是手动“落地”了，编译环境也就稳了，再也不会遇到Android Studio下载NDK失败的情况。