Android Studio 3.1.1创建带C++支持新项目时Gradle配置失败求助

架构老林

2026-5-25

我之前也碰到过这个一模一样的问题，给你几个亲测有效的解决思路：

解决Android Studio 3.1.1创建带C++支持项目的Gradle构建错误

检查NDK配置是否正确
首先确认你的Android Studio已经安装了NDK，并且在项目根目录的local.properties文件里指定了正确的NDK路径，格式大概是这样：
```
ndk.dir=/Users/你的用户名/Library/Android/sdk/ndk-bundle
```
如果路径不对，改成你本地NDK的实际存储路径，然后点击Sync Now重新同步Gradle。
升级Gradle插件版本
3.1.1版本的Android Studio对应的Gradle插件存在一些兼容性小问题，你可以尝试升级到同系列的稳定版本。打开项目根目录的build.gradle（注意是Project级别的那个），修改gradle插件的版本，比如改成3.2.1：
```
dependencies {
    classpath 'com.android.tools.build:gradle:3.2.1'
}
```
同步后让Gradle自动下载对应版本的插件。
清理IDE缓存并重启
缓存文件损坏是这类配置错误的常见诱因，操作步骤很简单：
1. 点击顶部菜单栏的File -> Invalidate Caches / Restart
2. 在弹出窗口选择Invalidate and Restart，等待IDE重启后重新构建项目
检查CMake版本并指定
带C++支持的项目依赖CMake，先通过SDK Manager -> SDK Tools确认你安装了3.6.0以上的稳定版本。然后在Module级别的build.gradle里明确指定CMake版本：
```
android {
    ...
    externalNativeBuild {
        cmake {
            version "3.6.0"
        }
    }
}
```
手动指定CMake路径
如果IDE没自动识别到CMake路径，也可以在local.properties里添加：
```
cmake.dir=/Users/你的用户名/Library/Android/sdk/cmake/3.6.0-rc2
```
替换成你本地CMake的实际安装路径即可。