一、USB连接设备执行run "app"时Build报错的原因及解决方法 #

作为首次使用Android Studio的新手，这个阶段的Build报错大多和基础配置、设备连接有关，我整理了最常见的几种情况和对应的解决办法：

• USB调试未开启或设备未授权
  这是最常见的原因！首次连接设备时，你需要先开启设备的「开发者选项」：打开设备设置→关于手机→连续点击「版本号」直到提示开发者模式已开启，然后回到设置找到「开发者选项」，打开「USB调试」。连接电脑后，设备上会弹出授权提示，一定要点击「允许」让电脑访问你的设备。如果还是识别不了，打开Android Studio底部的Terminal，执行adb kill-server然后adb start-server重启ADB服务试试。

• SDK版本与设备不兼容
  如果你的项目配置的compileSdkVersion或targetSdkVersion高于设备的系统版本，就会出现Build报错。比如你用API 34编译，但设备是Android 10（API 29），就会不兼容。解决方法是：打开模块级别的build.gradle文件，把compileSdkVersion和targetSdkVersion调整到设备支持的版本；或者打开SDK Manager（工具栏的SDK图标），下载对应设备系统版本的SDK Platform。

• 依赖库冲突或未同步完成
  项目里的依赖库版本不一致、重复引用，或者Gradle同步没完成，都会导致Build失败。先试试点击Android Studio右上角的「Sync Project with Gradle Files」按钮（那个像刷新的图标），让Gradle重新同步依赖。如果同步时提示缺失依赖，直接确认下载即可；如果是冲突，检查build.gradle里的依赖项，把重复的库删掉，或者统一版本号。

• USB驱动未正确安装（Windows用户居多）
  Windows系统经常会因为缺少对应设备的USB驱动，导致无法识别Android设备。你可以去设备厂商的官网下载对应型号的驱动安装；如果是Google设备或部分兼容设备，也可以在SDK Manager里下载「Google USB Driver」。

• Gradle版本不匹配
  Android Gradle Plugin和Gradle本身的版本需要对应，比如Plugin 8.1.0需要搭配Gradle 8.2。如果版本不匹配，Build时就会报错。打开项目级别的build.gradle文件，检查两者的版本是否对应，要是本地没有对应的Gradle，Android Studio会自动提示下载，耐心等下载完成就行；也可以手动下载Gradle压缩包，解压到指定的Gradle目录。

二、官网安装后频繁出现需下载文件的报错，是否属于常见现象？ #

答案是非常常见，不用太担心！主要原因有这几点：

1. Android Studio的官方安装包是「基础版」，只包含了核心运行组件，像不同版本的SDK Platform、模拟器镜像、Gradle、NDK这些工具，都是根据你的项目需求和设备情况按需下载的。比如你要开发Android 13的应用，就得下载API 33的SDK；要用到模拟器，就得下载对应系统的System Image，这些都是正常的。

2. 网络环境不稳定也会导致下载中断，部分组件没下载完整，下次打开项目或构建时就会触发重新下载。

3. 如果是导入别人的项目或者从Git拉取的项目，项目本身用了特定版本的Gradle或依赖库，而你本地没有，自然会提示下载。

不过如果频繁出现无意义的重复下载提示，可能是这些问题导致的，可以试试解决：

• 切换稳定的网络（比如有线网络），或者在Android Studio的设置里配置国内镜像源：打开Settings→Build, Execution, Deployment→Gradle→Android Studio，在gradle.properties里添加国内镜像地址，加速下载。

• 清理Android Studio缓存：点击File→Invalidate Caches...→勾选「Invalidate and Restart」，重启后很多缓存导致的问题都会解决。

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