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

先确认是否真在下载 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…”不动，或者突然变灰、点了没反应，那基本可以确定：下载失败了。

强制清除 NDK 缓存并重试

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

• 第一步：关掉 Android Studio。
• 第二步：找到并删除 NDK 的临时下载包。
  Windows 上路径在 %USERPROFILE%.androidrepositoryndk- 开头的所有 .zip 和 .temp 文件；
  macOS 则是 ~/Library/Android/sdk/.android/repository/ndk- 开头的同名文件。统统删干净。
• 第三步：删除已经解压但可能损坏的旧版本文件。
  进入 SDK 根目录下的 ndk 文件夹（比如 D:AndroidSdkndk），把里面的子文件夹全删了，只保留空的 ndk 文件夹本身。
  这一步很关键，不然 Studio 会以为 NDK 已经存在，直接跳过下载流程，去尝试复用那些已经损毁的旧文件。
• 第四步：重启 Android Studio，等 IDE 完全加载完毕（大约十秒）。
  再次打开 SDK Manager，重新勾选 NDK，点击 Apply。这时候它才真正重新开始下载。

改用清华镜像源下载 NDK

如果你所在的网络环境访问 Google 服务不太顺畅，那不妨直接切换镜像源。
这不丢人，算是国内开发者的常规操作。

推荐第一个方法：通过 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%.androidrepositories.cfg（Windows）或 ~/.android/repositories.cfg（macOS）。
在文件末尾另起一行，粘贴上面那个镜像地址，保存，重启 Android Studio。

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

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

到这一步，NDK 算是手动“落地”了，编译环境也就稳了。

《夸克》非常好用的免费AI浏览器

下载APP查看