Android Studio新建空白Activity项目报错：未声明ConstraintLayout元素

以下是针对性的解决方法，按优先级尝试：

1. 检查并确认ConstraintLayout依赖 #

打开项目根目录下的 app/build.gradle（Module级别的gradle文件），确保dependencies块中包含ConstraintLayout的依赖：

dependencies {
    // 保留项目原有其他依赖
    implementation "androidx.constraintlayout:constraintlayout:2.1.4" // 可替换为更高稳定版本
}

完成后点击Android Studio右上角的 Sync Project with Gradle Files 按钮同步项目。

2. 明确指定最新稳定依赖版本 #

若默认版本拉取失败，可通过Android Studio的「Project Structure -> Dependencies」搜索ConstraintLayout获取最新稳定版本，替换到app/build.gradle中后重新同步。

3. 检查Gradle仓库配置 #

打开项目根目录的 build.gradle（Project级别的gradle文件），确认repositories块包含官方仓库或可用镜像：

repositories {
    google()
    mavenCentral()
    // 可选添加国内镜像加速下载
    // maven { url 'https://maven.aliyun.com/repository/google' }
    // maven { url 'https://maven.aliyun.com/repository/public' }
}

修改后重新同步项目。

4. 清除Gradle缓存并重启 #

• 点击菜单栏 File -> Invalidate Caches...，勾选「Invalidate and Restart」重启Android Studio。
• 手动删除项目根目录下的 .gradle 文件夹和 app/build 文件夹，之后重新同步并构建项目。

5. 核对XML命名空间 #

确认布局XML中的命名空间无拼写错误，你的代码中这部分是正确的，可再次核对：

xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"

内容的提问来源于stack exchange，提问作者Mikyas Tewodros