何为自律装 Android Studio 这件事，看起来就是一个“下载、双击、下一步、Finish”的标准流程，但真上手的人都知道，这里面坑多得很。热搜词里一半是“下载”“历史版本”“汉化”“Gradle配置”“打包”这些，说明大家卡住的从来不是点那几个按钮，而是装完之后的环境、路径、网络、版本匹配这一连串问题。这也不怪新手，Android Studio 的安装和第一次启动涉及到的组件比普通软件多得多，任何一个环节版本对不上，都会引发一道全新的报错。
这篇文章我就按自己这几年用 Android Studio 的经验，从安装前的机器检查，到下载渠道选择，再到首次启动的 SDK 和 Gradle 配置，最后落到项目导入、打包出 APK，把整个流程完整走一遍。全程会标注出哪些是新手容易踩的坑、哪些是我自己踩过之后才发现可以绕开的弯路，尽量让你照着走就能顺顺利利装好、跑起来、打出第一个包。
1. 安装前的硬性准备
这一步很多人直接跳过，结果装到一半发现磁盘不够、JDK 版本冲突、系统位数不支持，回头再来删东西换版本，折腾两三个小时。装 Android Studio 之前，先把机器状况摸清楚，能省掉后面一大半的麻烦。
1.1 JDK 版本：不是越大越好，也不是必须自己装
先说结论：新版的 Android Studio 完全不需要你自己手动装 JDK。从 2020 年后的版本开始，Android Studio 内部自带了一个 JetBrains Runtime（JBR），它是基于 OpenJDK 定制过的运行时，版本一般和 AS 主版本强绑定。比如 2023 年之后的版本自带 JDK 17，2024 年之后的版本开始向 JDK 21 过渡。你在新建项目或者编译的时候，AS 默认走的是这个内置运行时，而不是系统 PATH 里的 java。
那为什么还要单独提 JDK？因为老机器上可能装了多个版本的 JDK，而且把 JAVA_HOME 环境变量指到了某一个特定版本，例如 JDK 8 或者 JDK 11。这时候 AS 发现系统里有强制指定的 JAVA_HOME，可能会去尝试用它，导致编译报出“Unsupported class file major version”这种经典的版本错误。
我的建议是：如果你只是为了跑 Android 开发，直接忽略 JDK 环境变量这回事，让 AS 用自己的内置 JBR。 只有当你需要用命令行工具跑 Gradle 脚本，或者做 CI/CD 构建时，才需要手动保证系统里有匹配版本的 JDK。你可以先在终端或者 CMD 里执行一下，看看当前环境是什么状态：
bash复制java -version
如果这里显示的版本是 1.8 或者 8.x，而你的 AS 是 2023 以后的版本，就建议把系统的 JAVA_HOME 去掉，或者升级到 17 以上，避免 AS 在某些特殊动作（比如导入老项目、调试 Gradle 脚本）时被外部 JDK 干扰。
1.2 硬件底子：内存和磁盘要留够，别用 32 位系统
Android Studio 的安装包本身只有几百 MB，但它真正吃掉空间的是内侧的这些东西：
- Android SDK：光是一个 SDK Platform 加上对应的 Build Tools、Platform-Tools，就要 3~5 GB；
- Gradle 依赖缓存：第一次构建任何项目，都会把大量 AAR/JAR 依赖拉进本地缓存，这部分几年下来 10 GB 很正常；
- AVD 系统镜像：如果你想跑模拟器，一个系统镜像动辄 1~2 GB，而且运行时要占大量内存；
- SDK 平台历史版本：只要 Project Structure 里检测到你打开的项目用了旧版 SDK，AS 就会自动去下载，几个版本叠加起来空间压力更大。
所以装之前先看一眼磁盘剩余空间，建议至少留 30 GB 可用空间。内存方面，官方写的是 8 GB 最低，但实测下来 8 GB 开一个模拟器再加一个大型项目，基本卡到没法用。我自己用的 16 GB 处于“够用偏紧张”的状态，如果你打算玩 Flutter、React Native 这类跨端开发，或者以后要跑大型 Android 项目，直接按 32 GB 去准备，体验完全两回事。
还有一点，系统位数必须检查。现在的 Android Studio 早就不支持 32 位操作系统了，Windows 的话必须是 64 位，macOS 要求 11 以上，Linux 也有对应的 glibc 版本要求。装之前最好是右键“此电脑”确认一下系统类型，这一步太基础，但很多人装完打不开其实就差在这里。
1.3 下载渠道：别在来路不明的网站上拿安装包
搜索引擎里搜“android studio 下载”，前几页经常会出现各种“下载站”，看起来提供的是官方安装包，实际捆了一堆全家桶。我的经验是认准两个渠道：
- 官网：developer.android.com/studio，这里会提供最新稳定版，以及对应平台的安装包（Windows exe、macOS dmg/zip、Linux tar.gz）；
- 历史版本仓库：官方 Archive 页面，地址在官网首页的“Download options”里能找到，里面收录了从 Android Studio 1.0 到现在的所有版本。
为什么历史版本重要？两个场景：一是公司或团队锁定了某个特定 AS 版本，比如做维护老项目的团队经常固定在 2021.2.1；二是个别小版本有稳定性问题，社区反馈强烈，很多人会退回上一版。搜索词里出现“android studio 2021.2.1 下载”和“android studio 历史版本”就是这个原因。从官方 Archive 下载历史版本，至少能保证文件没被篡改过。
国内网络访问官网偶尔会抽风，慢或者打不开，这种情况可以试试国内镜像源。清华 TUNA、阿里云、腾讯软件源都镜像了 Android Studio 安装包和 Android SDK 组件。镜像站只提供原封不动的安装包，适合官网速度不理想时救急。但无论如何，我不建议从非官方的小网站下载，尤其是不带校验的压缩包，里面被塞进恶意代码的事每年都有。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 下载、安装与路径规划
安装本身是个体力活，但“装在哪”这个决定会长时间影响你后面的使用体验。很多人图省事，一路默认“下一步”，最后 SDK、Gradle 缓存、系统镜像全塞在 C 盘，等到 C 盘爆红的时候才来后悔。下面分别说 Windows 和 macOS 下的安装细节。
2.1 Windows 安装：路径里绝对不要出现中文
Windows 版的安装包是一个 .exe 文件，双击后进入安装向导。这里有几个点别直接跳过：
- 安装路径不要有中文和空格。比如 D:\Android\Android Studio 这种路径没问题，但 D:\软件\安卓开发工具 这种路径，后面 Gradle 构建时大概率会出现奇怪编码报错。Android 工具链对中文路径的兼容性一直不太好，宁可多建一层目录，也别给路径添麻烦；
- 协议和组件选择。安装向导会提示你选择安装哪些组件，默认是把“Android Virtual Device”和 SDK 一起装。如果你和我一样主要在真机上调试，AVD 组件可以不装，省空间；如果打算用模拟器，那就保留；
- 安装完后，向导会问是否要导入之前的设置。如果你之前没用过 AS，选“Don't import settings”；如果是从旧版本迁移，可以选默认导入，它会带着之前的配置和插件一起过来。
Windows 下希望你记住一个默认路径：C:\Users\你的用户名\AppData\Local\Android\Sdk。这是 AS 默认的 SDK 安装位置。问题在于 AppData 这个目录在 C 盘，而且路径很深，一旦后面要配环境变量或者手动找 sdkmanager，操作起来非常别扭。
这里我给的建议是：在首次启动 AS 时的 SDK Setup 页面，把 SDK 位置改到一个自己规划好的目录，比如 D:\Android\Sdk。改动之后，AS 会把 SDK 的配置自动写进 C:\Users\xxx.android\ 下的配置文件里，不需要额外手动设置什么。只是需要记住这个位置，后面打开 Project Structure 时可以来回对。
顺带说一句，要不要配 ANDROID_HOME 环境变量？如果你只在 AS 图形界面里开发，完全不需要。只有当你用 Flutter、React Native，或者手动跑 adb、sdkmanager 这类命令行工具时，才需要把 ANDROID_HOME 指向 SDK 目录，并把 %ANDROID_HOME%\platform-tools 加进 PATH，这样 adb 命令到处都能用。
2.2 macOS 安装：dmg 拖进 Applications，Intel/Apple Silicon 别选错
macOS 上，官方提供的是 .dmg 镜像文件。双击挂载后，把 Android Studio.app 直接拖进 Applications 即可。如果是从官网下载的 zip 包，解压后也整个放进 Applications 目录，然后在终端执行：
bash复制xattr -dr com.apple.quarantine /Applications/Android\ Studio.app
这一步的作用是取消 macOS 的 Gatekeeper 隔离标志，不然首次打开时会提示“已损坏”或“无法验证开发者”。这里要注意，Apple Silicon（M1/M2）机器必须下 arm64 架构的 dmg，Intel 芯片下 x64 版本，选错的话安装向导可能会直接打不开，或者在启动模拟器时性能异常。
macOS 下 SDK 的默认安装路径是 ~/Library/Android/sdk。这个路径不太好找，因为 Finder 默认是隐藏 Library 的。如果你不习惯在终端里操作，也可以在首次启动时改成 /Users/你的用户名/Android/Sdk，或者任何方便的位置，全凭个人习惯。mac 上要注意的是磁盘空间，Library 目录藏在隐藏位置，有时候空间不知不觉就被 SDK 和各版本模拟器镜像吃光了，建议定期用“关于本机-存储空间”瞄一眼。
2.3 网络代理与镜像：为什么进度条卡在 Downloading
启动 Android Studio，第一次进入时会自动下载几个基础组件。这一步在国内卡住的情况非常普遍，症状是界面一直停在某个“Downloading”阶段，百分比不动，或者反复报“Unable to access SDK manager”。
这不是你电脑有问题，而是 AS 默认访问的 Google 服务器在部分地区连接不稳定。解决办法有两个：
- 手动设置代理：在 AS 的设置里，打开 Appearance & Behavior → System Settings → HTTP Proxy，选择“Manual proxy configuration”，填一个可用的 HTTP 代理地址，端口通常是 80 或者 1080。没有稳定代理的情况下不推荐这招，因为填错了反而更卡；
- 改用国内镜像：这个在实际操作中更实用。AS 本身并没有一个“一键改镜像”的开关，但你可以通过修改 init.gradle 等方式把 Gradle 依赖源改成阿里云 maven 镜像，而 SDK 组件下载则可以在 SDK Manager 里手动指定镜像站点。不过坦白说，SDK 组件体积大，镜像覆盖不全，我常年用下来更稳的办法是配置 hosts 文件，把需要的域名解析到速度更快的 IP。
实操中最有效的还是先去官网或镜像站把 SDK 压缩包直接下载好，然后放到本地目录，再用 AS 的 SDK Manager 手动指定 SDK 位置。这样绕开了 AS 自己那个不算稳的下载流程，更适合网络环境一般的情况。这个话题我们放到第三节具体展开。
3. 第一次启动：SDK、中文界面与 Gradle
装好之后第一次打开，会进入一个设置向导，选 UI 主题、确认 SDK 路径、接受协议，然后就是漫长的“Downloading SDK components”。很多人的耐心就消耗在这一步。这里面的几个大坑，我挨个拆开讲。
3.1 SDK Manager：版本别贪多，装够用就行
SDK Manager 的入口在顶部 Toolbar 的“SDK Manager”图标，点开后你会看到三张页签：SDK Platforms、SDK Tools、SDK Update Sites。
SDK Platforms 里面列出的是各个 Android 版本的 API 平台包。新手常犯的毛病是全选、全下载、装完发现占了几十个 GB。正确思路是：
- 装一个当前稳定版，比如 API 34（Android 14）或 API 35（Android 15）；
- 如果你打开的是别人写的老项目，它要求的会是一个较低的 API Level，AS 会提示缺失，这时候再针对性补装；
- 同一时间至少保留当前使用版本和上一个次要版本，方便切换调试。
SDK Tools 里面需要注意三个东西：Android SDK Build-Tools、Android SDK Platform-Tools、SDK Manager。Build-Tools 负责把代码编译成中间字节码，一般是项目 Gradle 文件里指定哪个版本就用哪个；Platform-Tools 提供 adb 调试工具，建议始终保持最新；另外还有一个“Android SDK Command-line Tools”，在较新的 AS 中你可能会在工具目录里用到它。
接受协议这块很多人卡住过：列表页每个条目前面有个小方框，必须把某个版本的勾选上，然后点击右侧的“Accept”按钮，等协议状态变成 Accepted，才能点 Apply 开始下载。如果没接受直接点 Apply，系统会弹一个提示，但并不会告诉你哪个没接受，比较费解。全部就绪之后，右下角进度条会显示正在下载和安装，装完后底下会打绿色对勾。
SDK 装好后验证方式很简单：打开终端，进入 SDK 目录下的 platform-tools 文件夹，执行：
bash复制adb --version
能正常打印版本号，说明 platform-tools 没问题。再用命令行工具跑一下：
bash复制sdkmanager --list
可以列出所有已经安装和可用的 SDK 包，iPhone 里“正在下载但没写完”的包，在这里能看得明明白白。
3.2 AS 能不能设成中文界面？汉化的正确打开方式
很多人第一次问“Android Studio 怎么设置中文”的时候，其实是在下载页或者安装向导里看到了一排英文，心里犯怵。这里我直接给结论：官方支持中文界面，但需要手动安装语言包插件，不是设置里改一个选项就行的。
操作路径是：Settings → Plugins → Marketplace，搜索“Chinese (Simplified) Language Pack”，找到“中文语言包”插件，安装后重启。重启之后，整个 AS 菜单、弹窗、右键菜单都会变成简体中文。如果搜不到，多半是插件市场网络问题，需要把 HTTP Proxy 配置改成自动检测，或者手动配置代理后再试一次。
但我的个人建议是：尽量保持英文界面，或者汉化之后在需要网上搜教程时切回来。 原因很现实：中文互联网上绝大多数 Android Studio 教程、报错信息截图、Gradle 配置代码，用的都是英文界面词汇。汉化之后菜单名变成了“文件→新建→新建项目”，可教程里说的却是“File → New → New Project”，对不上号的时候反而加重困惑。
还有一个要注意的坎：第三方汉化包和老版本 AS 的兼容性。2020 年之前的老版本，官方没有中文语言包，网上流传的汉化包原理是替换 resources 目录下的语言文件，这种做法在升级 AS 后大概率失效，而且某些版本的汉化包会把菜单 ID 改坏，导致按钮点击无响应。如果确实需要中文，优先用官方语言包，版本适配永远是最稳的。
顺带提一个很多人不知道的细节：AS 自带的字体渲染和代码补全提示也可以带中文。代码里的注释、字符串甚至变量名用中文都没问题，但资源文件名、package 名、Module 名这类路径相关的标识符不要用中文，这跟安装路径不能有中文是同一个道理，构建系统的编码容错有限。
3.3 第一次新建项目：Gradle 同步慢到怀疑人生怎么办
走到这里，向导结束，AS 会跳出一个“Welcome to Android Studio”的欢迎页。点击“New Project”，选一个模板（新手通常选“Empty Views Activity”，就是最干净的空白页面），填好项目名称、包名、保存路径，然后点击“Finish”。
接下来就是最考验耐心的部分：第一次构建。项目创建后，AS 会自动执行一次 Gradle 同步，这个过程要完成两件大事：下载指定版本的 Gradle 发行版，以及下载所有项目依赖包。
Gradle 发行版存放在 C:\Users\你的用户名.gradle\wrapper\dists（mac 下是 ~/.gradle/wrapper/dists）目录下，每个版本一个子目录。第一次同步时进度条走特别慢，绝大多数原因就是这个 zip 包下载速度达不到预期。解决方法是我测试下来最有效的两种：
第一种：手动放 Gradle 发行版
打开项目根目录下的 gradle\wrapper\gradle-wrapper.properties 文件，看到 distributionUrl：
code复制distributionUrl=https\://services.gradle.org/distributions/gradle-8.7-bin.zip
用浏览器或者下载工具去 services.gradle.org 把对应版本的 zip 下载下来，然后放进上面那个 dists 目录对应版本的子目录里。AS 检测到本地已经有完整的 zip，就不会重新去下载了。下载 Gradle 发行版虽然体积有 100~200 MB，但胜在可以走浏览器加速。
第二种：改阿里云镜像
Gradle 同步的另外一大半时间花在下载项目依赖上。项目根目录的 settings.gradle 或 build.gradle 里，默认仓库是 google() 和 mavenCentral()。国内直连这两个源时好时坏，需要把仓库改成镜像源：
gradle复制pluginManagement {
repositories {
maven { url 'https://maven.aliyun.com/repository/google' }
maven { url 'https://maven.aliyun.com/repository/central' }
maven { url 'https://maven.aliyun.com/repository/public' }
google()
mavenCentral()
}
}
这段配置写在项目根目录的 settings.gradle 里，把阿里云镜像放在最靠前的位置。改完之后，点击 Toolbar 上的大象图标（Gradle Sync），依赖下载会通畅很多。这里要提醒一下：镜像只能解决依赖下载，解决不了 Gradle 发行版本体下载，所以两种方式往往要搭配用。
如果同步过程依然不顺利，可以把 Gradle 的构建日志打开看具体卡在哪一个环节：设置里搜“Gradle”，勾选“Offline work”可以先跳过网络检查，但前提是已经下载过一遍依赖。另外一个操作是 —— 直接打开 dists 目录，看看是不是多个版本的 zip 都在下载，有时候第一次同步失败后记录残留，导致后面每次同步都重复下载。把残留的 .part 文件删掉，重新触发同步，能解决很多不明不白的卡顿。
首次同步成功后，项目的 app 模块会出现 Android 文件夹树，MainActivity.kt 还有 res/layout/activity_main.xml 都在里面。到这里，AS 的“能打开、能创建项目、能编译”三个基本能力才算是真正装好了。
4. 从“装上”到“能用”：导入项目、改配置与打包
装 AS 不是目的，写出能安装到手机上的 APK 才是。第四个阶段，我集中讲两件事：怎么把别人的项目或者老项目顺利跑起来（对应的就是热搜里“移植 android studio 项目”这个问题），以及怎么打出自己想要的包。
4.1 导入别人的项目，最容易翻车的是版本不匹配
在 GitHub 上拉下一个开源项目，或者在同事那里拷贝了一份工程，用 AS 打开的方式必须是：File → Open，选择项目根目录（就是包含 settings.gradle 的那个文件夹）。
打开之后，AS 会启动 Gradle 同步。这一步翻车率极高，我整理过三大高频报错和排查思路：
报错一：“Minimum supported Gradle version is X.X. Current version is Y.Y.”
这表示项目要求的 Gradle 版本比当前环境的高。打开 gradle-wrapper.properties 看 distributionUrl，再对比报错提示里“Minimum supported”的要求。正常做法是把 distributionUrl 改成要求的版本，或者反过来，把项目的 distributionUrl 降级到本地已有的版本。改完再次同步。
值得单独讲一下：Android Gradle Plugin（AGP）和 Gradle 两者是有固定匹配关系的，不能随便配。大致对应规则如下表，我按实际编译器验证过的主要版本列出来方便对照：
| AGP 版本 | 最低 Gradle 版本 |
|---|---|
| 4.2.x | 6.7.1 |
| 7.0.x | 7.0.2 |
| 7.4.x | 7.5 |
| 8.0.x | 8.0 |
| 8.2.x | 8.2 |
| 8.7.x | 8.9 |
如果你改了 distributionUrl，记得同步后点菜单里的“File → Sync Project with Gradle Files”。注意，新版 AS 会弹出一个“AGP Upgrade Assistant”，可以帮你自动升级 AGP，但老项目升级 AGP 往往伴随 API 变动，建议只在必须的时候用，平时能不动就不动。
报错二：“SDK location not found”
这个最简单，项目打开后顶部消息栏经常显示“SDK location not found. Define a valid SDK location with an ANDROID_HOME environment variable or by setting the sdk.dir in the project's local properties file”。解决办法：项目根目录下 local.properties 文件里加一行：
code复制sdk.dir=D\:\\Android\\Sdk
路径填你自己的 SDK 绝对路径。如果你不明白为什么会有 local.properties 这个东西，可以把它理解成每台电脑自己的小配置，它不会提交到 Git，专门记录本机 SDK 位置。
报错三：“Could not resolve all artifacts for configuration...”
依赖源下载失败。把上面提到的 settings.gradle 仓库改镜像，然后重新同步。如果项目里用了比较罕见的第三方依赖，镜像也没有的话，就需要手动打了。下载对应 aar/jar 后放进本地 libs 目录，用 implementation files('libs/xxx.aar') 引入，这种属于偏门的操作，遇到再处理即可。
4.2 打包出 APK 和 AAB：两种产物，两个目的
项目能同步能编译后，第一步自然是把它装到手机上看看效果。最简单的打包路径：点击菜单 Build → Build Bundle(s) / APK(s) → Build APK(s)。右下角会弹提示“APK generated successfully”，点击提示里的“Show in Files”可以打开 APK 所在目录。
这个包是 debug 包，签名用的是 AS 自动生成的 debug keystore，只能用于开发调试和安装到自己的手机。在 app/build/outputs/apk/debug/ 目录下找到 app-debug.apk，用数据线连上开启 USB 调试的手机，直接拖进手机安装，或者用命令行安装：
bash复制adb install app-debug.apk
想让应用能对外发布，不能打 debug 包，得打 release 包并配置正式签名。入口在 Build → Generate Signed Bundle / APK，选择“APK”或“Android App Bundle”。签名文件（keystore）第一次打包时可以直接在向导里点击“Create new”，填好密钥库密码、别名、组织信息就可以生成。密钥库生成后必须妥善保管，后续升级版本还要用它签名。一旦丢失，已发布的应用就再也无法覆盖更新了。口令也尽量别设太简单，丢了密钥库比忘了密码还麻烦，两者都是不可逆的。
打包过程中也会遇到各种报错，热搜里的“资源重复错误”是其中一个典型，现象是构建时提示“Duplicate resources”。常见于 res 目录下出现了两处相同名称的资源，或者合并库时不同 module 里都有同名的 drawable、layout。排查方法：看报错信息里会给到冲突的路径，例如 values/strings.xml 里面的某条字符串定义被重复声明。解决途径是删除冗余的那份，或者给资源名加前缀做区分。还有一种情况是第三方依赖里资源重名，这种情况可以打开模块的 build.gradle，给对应依赖配置 exclude：
gradle复制implementation('com.example:lib:1.0.0') {
exclude group: 'com.example', module: 'lib-common'
}
4.3 自定义 UI 组件、数据库检查这类进阶功能，其实都自带
搜索词里“android studio 自定义组件”“android studio 有数据库插件吗”经常出现。前者是开发需求，后者是对工具能力的疑问，一并回答。
自定义组件在 AS 里的标准玩法是靠 XML 布局和代码结合。你可以在 res/values/attrs.xml 里自定义属性，在自定义 View 类的构造方法里读取并绘制，然后拖进预览面板实时查看效果。AS 的 Layout Editor 对自定义 View 的支持很成熟，布局预览时能渲染出自定义属性，不需要每次跑模拟器一遍遍地试。
数据库方面，新版 AS 直接在 View 栏里集成了“App Inspection”，其中包含 Database Inspector，不需要额外安装任何插件就能实时查看应用的 SQLite 或 Room 数据库，可以看到表内容、执行 SQL 查询、甚至改数据。要启用它，运行 Debug 版本的应用，然后在 App Inspection 窗口里选中运行中的进程即可。如果你在搜索里看到“android studio 有数据库插件吗”，大概率是还没发现这个内置工具，它比任何第三方插件都好用，因为它直接感知应用的运行时快照。
5. 常见问题速查与避坑经验
写这类文章的常规操作是附上一张问题表，我把高频踩坑点都放在这里，顺手给出对应的处理方案。这些内容不是我一次遇到就总结出来的，而是反复重装系统、升级版本、帮同事排查出来的，每一条都有对应的真实场景。
| 现象 | 原因 | 解决办法 |
|---|---|---|
| 安装后双击无反应 | 系统位数不匹配 / 下载包损坏 | 重新下载对应平台的 x64 安装包，mac 用 xattr 解除隔离 |
| 首次启动卡在 Downloading SDK | 网络访问 Google 服务超时 | 手动下载 SDK 压缩包并指定路径，或配置 HTTP Proxy |
| 新建项目后 Gradle 同步一直转圈 | Gradle 发行版下载失败 | 手动下载 zip 放进 dists 目录，或用国内镜像 |
| 导入项目报 Minimum supported Gradle version | AGP 与 Gradle 版本不匹配 | 打开 gradle-wrapper.properties 修改 distributionUrl |
| SDK location not found | 本机 local.properties 没有指定 SDK 路径 | 项目根目录 local.properties 里配置 sdk.dir |
| 编译时报 Chinese path / Illegal characters | 项目路径或用户名包含中文 | 将项目移到纯英文路径下，路径中不要有空格和中文 |
| APK 生成后安装到手机提示“应用未安装” | 签名不一致覆盖旧应用 | 卸载旧应用后重新安装，或统一使用同一份签名文件 |
| 模拟器启动黑屏或无法启动 | HAXM 未装 / Hyper-V 与模拟器冲突 | Windows 开启“Windows Hypervisor Platform”，或安装 HAXM |
| 构建报 Build failed: duplicate resources | 资源重名冲突 | 排查报错给出的资源文件路径，删除或重命名冲突项 |
再说几个我自己多年用 AS 总结出来的习惯，不一定到处都有人写，但对维护开发机长期体验影响很大：
第一，Gradle 缓存目录要定期清理。C 盘的用户目录 .gradle/caches 里全是一个个项目的历史依赖，一年能堆到 20 GB。清理时删掉 caches 目录之后重新同步一遍即可，旧项目会自动重新拉对应依赖。
第二，AS 更新前先看一眼当前的 AGP 版本。直接升 AS 到最新版，旧项目的 AGP 可能不支持新版构建工具，导致同步直接失败。正确做法是先用 New Project 建一个全新的项目试探兼容性，确定没问题后再同步旧项目。
第三，开发机内存不够时，别硬开模拟器。真机调试速度远胜模拟器，而且能触发真实的各种网络状态、传感器信号。模拟器更适合做多机型适配时使用。
很多人在最初安装阶段就被劝退了，其实 Android Studio 的安装难点并不在安装本身，而在于它连接了三层外部依赖：JDK 运行环境、Android SDK 组件、Gradle 分发与依赖仓库。每一层都涉及网络和版本匹配，只要提前规划好路径和镜像，多试个一两次，后面写代码的顺畅程度就会大大提升。至少对我来说，每次重装完开发机，把 Gradle 发行版手动放好、仓库改好镜像、SDK 固定到自己熟悉的目录，剩下的工作基本一路顺风，再也没被下载问题拦过路。