2026最新版Android Studio安装配置全攻略：从零跑通模拟器与APK打包

刚给一台新笔记本装完 Android Studio，从下载安装到跑通第一个项目，整个过程踩了不少坑。网上铺天盖地的教程要么过时，要么只讲一半，遇到 Gradle 同步失败、SDK 组件下载不动、AVD 起不来就直接卡死。所以我把 2026 年最新版的完整安装和配置流程重新梳理了一遍，包括 Windows 和 macOS 两套环境，从零开始到跑通模拟器、打出 APK，全程实测可用。

这篇文章适合完全没装过的纯新手，也适合装了但一直没配顺手的同学。我会把每一处“为什么这么配”都讲清楚，而不是只丢给你一串命令。如果你已经装了旧版本，直接看第 3 节和第 5 节，重点是 SDK 和 Gradle 的配置。

1. 安装前的准备工作与版本选择

1.1 2026 版有哪些值得关注的变化

先说一个很多人忽略的点：Android Studio 的版本命名从 2024 年开始就切换到了以年份命名的规则，2026 最新版对应的内部版本号是 Narwhal 2025.1.1（注意，2026 年推荐的是 2025.1.1 这个稳定分支，不要看到 2026 字样就以为必须下载带 2026 的版本）。它与旧版相比有几个关键变化，直接关系到安装配置方式：

• 内置 JBR（JetBrains Runtime）从 JBR 17 升级到了 JBR 21，这意味着你不再需要手动配置系统 JDK 来运行 IDE 本身，但 Gradle 构建过程对 JDK 版本有独立要求。
• SDK 平台工具（platform-tools）和构建工具（build-tools）的下载方式没变，但默认 API Level 升级到了 36，Android 16 的 SDK 成了标准配置。
• 首次启动向导的流程做了简化，默认勾选的 SDK 组件更少，但如果你直接点“Next”跳过，后面编译老项目时会提示缺少旧版 SDK 平台。
• Gradle 版本锁定的策略更严格，2026 版默认生成的 wrapper 指向 Gradle 8.13，如果你打开的是 2021 年以前的老项目，大概率会遇到版本兼容性警告。

这些变化决定了你在安装时不再需要像 2018 年那篇老教程一样手动去装 JDK 8 再配环境变量，但同时也意味着新的坑会更隐蔽——比如 Gradle 版本冲突、AGP（Android Gradle Plugin）与 Gradle 的匹配问题。

1.2 硬件和系统环境要求

看到这里可能有人会觉得我在凑字数，但我真遇到过在 4GB 内存的旧电脑上强行装 AS 2026 然后卡到怀疑人生的同学。直接说结论，官方列出的最低要求看看就行，真正能“顺畅开发”的配置大概是这样的：

我个人的经验是，安装目录所在分区必须留出至少 30GB，其中 SDK、Gradle 缓存和 AVD 系统镜像这三块是最大的空间消耗者。如果你用的是 C 盘空间紧张的 Windows 电脑，强烈建议 SDK 放到 D 盘，后面第 3 节会说具体怎么改。

1.3 下载渠道与版本选择

Android Studio 的下载渠道主要有两个：一个是官方 Android 开发者网站，另一个是各镜像站。官方地址我就不完整贴了，关键词是“Android Studio download”，进去之后能看到一个很大的下载按钮。操作系统选择器会自动识别你的系统，但有一个细节好多人没注意到——点击“Download Options”可以看到所有历史版本。

建议下载策略：

• 稳定版优先：如果你是用于学习或日常开发，不要碰 Canary 和 Beta 渠道，Bug 多到你怀疑人生。
• 历史版本需求：某些老项目的 AGP 版本要求特定 AS 版本，或者你的电脑配置太低跑不动新版，可以从历史版本列表里选。下载页面的时间线检索功能在 2026 版做得很清晰，每个版本都标注了对应的 AGP 最低版本。
• 中文版与英文版：Android Studio 的安装包没有独立的中英文区分，都是多语言版本，安装后可以在设置里切换，这点我第 4 节专门讲。

下载完成后，Windows 用户拿到的是.exe或.zip文件。.exe是安装向导版，.zip是免安装版。我个人推荐.exe版，因为安装向导会自动处理环境变量和文件关联；.zip版虽然解压就能用，但后续命令行工具（如adb）的路径配置全得手动来。

1.4 安装前的环境预检

这一步是我从无数次重装系统后的安装经历里总结出来的。在双击安装包之前，先把三件事确认好：

第一，确认 Windows 没有开启“S 模式”。S 模式只允许安装 Microsoft Store 里的应用，会直接拦截 Android Studio 的安装。第二，确认系统用户名不包含中文。这一点极其关键但总是被忽略，Android Studio 的 Gradle 构建工具链对中文路径的支持到现在都不完善，如果你用户名是“张三”，那么构建缓存路径就会是C:\Users\张三\.gradle，大概率会在编译时出现玄学报错。第三，检查杀毒软件。Windows Defender 通常不会误报，但某些第三方的“安全卫士”会把 Android Studio 的 SDK 管理器进程当病毒杀掉，导致 SDK 下载一半就消失。

以上三项确认完，再双击安装包。如果你是用 macOS，那顺便确认一下芯片类型——是 Apple Silicon 还是 Intel 芯片，这决定了你下载的是arm64版还是x64版。

2. 安装流程与首次启动配置

2.1 Windows 安装过程实战

Windows 安装向导几乎是纯傻瓜式的，但有几个选项值得停下来想一想：

• 安装路径：默认是C:\Program Files\Android\Android Studio，我建议改到D:\Android\Android Studio或类似的非系统盘。原因很简单：IDE 本身的体积越来越大，加上plugins目录和日志文件，时间久了能到几个 GB。
• 创建快捷方式：默认勾选就行，方便找。
• 安装类型：如果你只需要写 Android 应用，选“Standard”；如果还要搞 Flutter 或 React Native 开发，选“Custom”并勾选对应的组件。

安装过程大概持续 3-8 分钟，取决于磁盘速度。完成后不要立即勾选“Start Android Studio”并点 Finish，先在桌面右键检查是否生成了快捷方式，然后断网状态下启动一次（如果有人遇到下载组件失败，断网启动是绕过首次下载的第一步）。

一个很多人没遇到过但真实存在的细节：安装完成后，C:\Users\你的用户名\.android目录会被自动创建。如果你之前安装过旧版，这个目录里可能残留了一个adbkey文件，它在某些情况下会导致新版无法正常连接真机。解决办法是安装完成后删除.android目录（注意不是 SDK 目录），让系统重新生成密钥。

2.2 macOS 安装过程实战

macOS 版是一个.dmg镜像文件，双击挂载后把Android Studio.app拖入 Applications 文件夹即可。首次打开时，macOS 的 Gatekeeper 会提示“无法验证开发者”，这时去“系统设置-隐私与安全性”里点“仍要打开”就行。

Apple Silicon 芯片的 Mac 用户注意一点：首次启动向导会检测你的 Rosetta 2 是否已安装，如果没有，会弹出提示让你安装。Rosetta 是 Apple 为 M 系列芯片提供的 x86 兼容层，它的存在是为了在安装一些只提供 x64 版的开发工具链时不至于卡死。你可以在终端执行：

softwareupdate --install-rosetta --agree-to-license

另外，macOS 版的界面字体渲染比 Windows 舒服很多，但如果你用的是非 Retina 的外接显示器，建议在设置里把 UI 字体调大一点，否则整体界面会显得非常紧凑。

2.3 首次启动：SDK 组件下载与配置

第一次启动 Android Studio 时，会弹出一个“Android Studio Setup Wizard”。这个向导做的事，就是帮你把 SDK 的基础组件下载下来。这一步是全网教程最容易“跳过”的一步，但也是最关键的一步。

向导会让你选择“Standard”还是“Custom”。我建议选 Custom，因为 Standard 模式会自动把 SDK 装到用户目录下（Windows 是C:\Users\用户名\AppData\Local\Android\Sdk），这个位置又深又不利于后续配置。Custom 模式下你可以把 SDK 路径改到D:\Android\Sdk（Windows）或~/Library/Android/sdk（macOS，这个是默认路径，不用改）。

SDK 组件选择界面，默认勾选的内容包括：

• Android SDK Platform 36：即 Android 16 的 API 36 平台，用于编译目标版本对应的系统接口。
• Android SDK Platform-Tools：包含adb、fastboot等基础命令行工具。
• Android SDK Build-Tools：包含aapt2、d8、r8等构建期工具。
• Android SDK Emulator：运行安卓模拟器的核心组件。

接受协议后进入下载。这里最大的坑是下载速度。如果你在国内网络环境，直接从 Google 服务器拉取 SDK 组件可能只有几十 KB/s 甚至直接超时。解决办法有两个：一是用代理，二是修改 SDK 下载源。修改下载源的方式我详细说下。

Android Studio 的 SDK 组件下载地址是在https://dl.google.com/android/repository/repository2-1.xml这个配置文件中定义的。你可以通过替换$ANDROID_HOME下的sdkmanager配置来指向镜像，但更简便的方法是直接在 IDE 设置中配置代理（HTTP Proxy），或者用镜像站环境的加速 DNS。考虑到合规性这里就不展开代理的具体方法了，如果你有可用的加速方案，直接在 Settings - Appearance & Behavior - System Settings - HTTP Proxy 里配置就行；如果没有加速方案，多试几次官网下载，或者错峰下载（凌晨速度会快一些）。

还有一个实用小技巧：如果你身边有一台已经装好 SDK 的电脑，直接把它整个 SDK 目录复制过来（注意平台工具需要匹配，Windows 和 macOS 的platform-tools不能混用），然后用向导“选择已有 SDK”的方式指向这个目录，可以省掉大量下载时间。这也是老手最常用的“移植”方案。

2.4 创建第一个项目验证安装

完成向导后，你会进入欢迎界面。选“New Project”，模板选择“Empty Views Activity”或者“Empty Activity”，命名随意，比如MyFirstApp。点 Finish 后会触发第一次 Gradle 同步。这个过程就是整个安装配置中最容易出问题的环节，如果你前面 SDK 配好了，那么这里大概率能顺利通过。

等左下角出现 BUILD SUCCESSFUL，并且项目结构树里能正常展开app/src/main/java目录时，说明你的安装已经成功了一大半。此时建议顺手点一下菜单上的“Run”按钮，选一个模拟器或真机，跑通整个编译链路。这一步的意义是把问题提前暴露出来——如果你等到写完整个项目再第一次跑，错误排查的难度会成倍增加。

我第一次装完就跑项目，就是被 Gradle 下载依赖卡了半小时，后来才知道是 Gradle 发行版的下载地址被墙了。这个问题我在第 5 节专门解释。

3. 核心配置：SDK、JDK 与环境变量

3.1 SDK Manager 详解：该装哪些组件

很多教程在这里只会跟你说“点一下 SDK Manager 然后全选”，这其实是偷懒的说法。全选的后果是你的硬盘多出好几个 GB 用不上的旧版本 SDK 平台。正确的做法是，针对你现有的项目需求来装。

进入方式：菜单栏 Tools - SDK Manager，或者欢迎界面右下角 Configure - SDK Manager。

一个合理的组件清单是这样的：

判断自己需要哪些历史版本，一个简单方法是打开项目的build.gradle文件，找到compileSdk配置。比如compileSdk 33，那就需要 API 33 的 Platform。如果你现在只做新项目开发，装 API 36 和 35 就足够覆盖绝大多数场景了。

SDK Manager 界面中有一个“SDK Update Sites”标签页，这里列的是 SDK 组件仓库下载地址。在国内环境下，这里也可以配置镜像站点，但我还是提醒一句：修改需要谨慎，因为部分镜像站点并不完整，尤其在系统镜像和 NDK 组件上经常缺失，到时候报错反而更难排查。我的建议顺序是：默认源下载优先，确实不行再考虑镜像，且只对单个组件做镜像，不要全局替换。

3.2 关于 JDK：到底要不要装、装哪个版本

这是“2026 最新版教程”里最容易误导人的地方。Android Studio 从 2020 年之后（Arctic Fox 版本起）就内置了 JBR，所以你不需要为了“运行 Android Studio”而手动装 JDK。但这里有一个边界：Gradle 守护进程和 AGP 的构建过程使用哪个 JDK，是由 Gradle JDK 设置决定的。

在 2026 版的默认设置中，Gradle JDK 指向的就是 IDE 内置的 JBR 21。大部分情况下，你不需要改变它。但如果你遇到下面这些场景，就需要单独装一个 JDK：

• 你的项目是多模块的大型项目，依赖了只在 JDK 11 上表现稳定的旧版 Kotlin 插件；
• 你需要用到 Java 8 语法特性，但 AGP 升级后默认编译级别变化导致报错；
• 你本地另有 Android 开发，需要频繁切换 JDK 版本。

装 JDK 的话，首选是 Azul Zulu 或者 Eclipse Temurin 的 JDK 17。为什么不是 JDK 21？因为 AGP 8.x 系列的兼容性矩阵里，最稳的是 JDK 17，JDK 21 虽然能用但某些老版本 AGP 不认。具体做法是去 Temurin 官网下载 JDK 17 的安装包，装完后在 Android Studio 的 Settings - Build, Execution, Deployment - Build Tools - Gradle 里，把 “Gradle JDK” 切换到 “jbr-17” 或者你本地安装的 JDK 17。

3.3 环境变量配置：JAVA_HOME、ANDROID_HOME 与 PATH

严格来说，2026 版的 Android Studio 已经不需要你手动配置任何环境变量了。IDE 在启动时会将内置的 JBR 和 SDK 路径注入到自己的子进程环境中。但有两个场景仍然需要你手动配置：

一个是你需要在终端里直接使用adb、sdkmanager等命令行工具；另一个是你使用其他构建工具（比如fastlane、uniapp的 CLI）时，它们需要读取ANDROID_HOME环境变量。

Windows 设置环境变量的流程：右键“此电脑” - 属性 - 高级系统设置 - 环境变量。在系统变量（注意是系统变量不是用户变量，因为命令行工具需要全局访问）中新建：

变量名: ANDROID_HOME 变量值: D:\Android\Sdk

然后在Path变量中追加：

%ANDROID_HOME%\platform-tools %ANDROID_HOME%\cmdline-tools\latest\bin %ANDROID_HOME%\emulator

第一行是为了用adb；第二行是为了用sdkmanager；第三行是为了在终端里直接启动模拟器。如果你不想把模拟器相关变量加进去，只在 Android Studio 里面运行模拟器也没问题。

macOS 用户则是在~/.zshrc文件中添加：

export ANDROID_HOME=$HOME/Library/Android/sdk export PATH=$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/cmdline-tools/latest/bin

配置完成后，重新打开终端敲adb version，如果能输出版本号，说明环境变量生效了。有一类特别隐蔽的问题是：adb命令能执行，但输入adb devices死活不识别设备，这往往跟 USB 驱动或设备授权弹窗有关，跟环境变量关系不大。我遇到过几个同学反复改环境变量，结果只是数据线是纯充电线——换根数据线立刻解决了，这种坑还真不是教程里能预判的。

4. 界面中文化与个性化设置

4.1 把 Android Studio 设置成中文

每次有人问“Android Studio 能不能设置成中文”，我都会先问一句：你确定要看中文吗？IDE 的中文翻译质量这几年虽然提升不少，但核心术语（如 “refactor”、“gradle” 等）仍然保留英文。尤其当你上网搜索报错信息或求助于 AI 工具时，英文界面的错误信息更容易对应上解决方案。所以我建议的做法是——了解怎么切换，但保持英文界面。

如果你确实需要中文界面，操作很简单：菜单栏 File - Settings（macOS 是 Preferences）- Plugins - Marketplace，搜索 “Chinese Language Pack”，找到 JetBrains 官方出的“中文语言包”插件，点击 Install，安装完成后重启 IDE 即可。这个插件是 JetBrains 官方维护的，质量比较可靠，基本覆盖了所有界面文本。

关于语言包的补充：这个中文包并不会翻译项目代码里的字符串，也不影响编译结果，它只是改变了 IDE 界面的显示语言。另外，官方中文包的翻译有时跟不上新版本的 UI 更新，可能会出现中英混杂的情况，这本身就是正常现象，不用慌。

如果你装了中文包后又后悔了，去 Settings - Plugins - Installed 里禁用或卸载即可，界面会立刻恢复英文。

4.2 几个最值得调的设置项

每次新装完 IDE，我建议空出 10 分钟在 Settings 里做下面这些调整，它们能显著改善日常开发体验。

字体与主题：Settings - Editor - Font。默认字体在上高分屏上偏小，建议开到 16-18 号。主题方面，如果你长期看白色背景容易疲劳，可以在 Settings - Appearance 里选择 Darcula 或自定义的 High Contrast 主题。我个人用的是 Darcula 背景加亮绿色字体，看代码时间长一点不容易累。

自动导入：Settings - Editor - General - Auto Import。勾选 “Add unambiguous imports on the fly” 和 “Optimize imports on the fly”。前者可以省去你手动敲import语句，后者会在你写完代码后自动清理掉未使用的 import，避免一堆警告黄线。

内存设置：如果你的电脑内存是 16GB，建议把 IDE 的堆内存从默认的 1280MB 调高到 2048MB 以上。修改方式：菜单栏 Help - Change Memory Settings。内存越大，IDE 在索引大型项目和运行 Gradle 构建时越流畅。注意这里不要调到超过系统内存的一半，否则会导致系统整体卡顿。

代理设置：Settings - Appearance & Behavior - System Settings - HTTP Proxy。如果你需要使用代理来加速插件和依赖的下载，选择 “Manual proxy configuration” 并填入你自己的本地代理端口，例如127.0.0.1加端口号。需要强调的是，代理只影响网络请求，不影响构建逻辑本身。如果你没有代理，就不动它，千万别填一个不存在的地址，反而会导致插件市场加载不出来。

4.3 模拟器的创建与系统镜像下载

模拟器（Emulator）是 Android 开发中绕不开的一环。在创建模拟器之前，先确保你装了 Emulator 组件和 System Image（系统镜像）。这两项都可以在 SDK Manager 中安装。

创建模拟器的入口是欢迎界面右上角的 “Device Manager”，或者工具栏上类似手机图标的按钮。点 “Create Virtual Device”，选择设备型号（建议选 Pixel 系列，屏幕分辨率和适配比较正常，不建议选平板，性能开销大），然后选择镜像。

系统镜像的选择有讲究：

• 推荐 Google APIs 版本：带 Google APIs 字样的镜像支持访问 Google 服务（地图、登录等），如果你不调用 Google 服务，装它只是多占空间。
• 不带 Google APIs 的纯 AOSP 镜像：启动更快，占资源更少，网络环境比较干净（没有 Google 服务的各种后台同步），但某些依赖 Google 服务 API 的 App 装上去会闪退。
• Play Store 镜像：自带 Google Play 商店。然而它和 Google APIs 镜像有所区别，Play Store 镜像不能在 root 环境下运行，某些调试操作会受限，日常开发首选 Google APIs 镜像就够了。

系统镜像下载同样面临网络问题，建议错峰下载或使用镜像加速。下载完成后，创建模拟器并点启动按钮，第一次冷启动可能需要 1-3 分钟，这是正常的。

如果你在 Intel 芯片的电脑上启动模拟器时遇到 “HAXM is not installed” 的报错，说明你没装硬件加速组件。在新版 Android Studio 里，Intel 平台建议使用 Android Emulator Hypervisor Driver（AEHD），它可以在 SDK Manager 的 “SDK Tools” 标签页中找到并安装。而 AMD 平台的对应组件是 Windows Hypervisor Platform，需要在 Windows 功能里开启。Apple Silicon 用户则不需要这些，模拟器直接使用系统的 Hypervisor framework。

5. Gradle 构建配置详解

5.1 先搞懂 Gradle 是什么

Gradle 是 Android 项目背后的构建引擎。你在 Android Studio 里点 “Run” 按钮时，IDE 其实是在调用 Gradle 去执行编译、资源打包、签名等一系列任务。如果你初次接触这个概念，可以把它想象成一个“建筑工地项目经理”——它读取你写好的“施工图纸”（build.gradle 文件），调度各种“施工队”（编译器、打包工具），最终帮你的 App 盖好“房子”（APK 文件）。

Gradle 本身是一个独立的开源工具，它不依附于 Android Studio。它有一个自己的发行版下载环节——你创建一个新项目时，Android Studio 会根据项目里gradle/wrapper/gradle-wrapper.properties文件中声明的版本号，去 Gradle 官方服务器下载对应的 Gradle 发行包。如果你发现首次同步卡在 “Downloading gradle-8.13-bin.zip” 这一步，原因就是你与下载服务器之间的网络连接不通畅。

5.2 项目级与模块级 build.gradle 深度解析

一个标准的 Android 项目至少会包含两个 Gradle 配置文件：

项目级 build.gradle（位于项目根目录），典型内容如下：

plugins { id 'com.android.application' version '8.7.2' apply false id 'org.jetbrains.kotlin.android' version '2.0.21' apply false }

这里声明的是插件及其版本号。com.android.application是 Android 构建插件（AGP），org.jetbrains.kotlin.android是 Kotlin 支持插件。apply false表示这只是一个声明，不对当前项目生效，真正生效的位置在模块级配置中。

模块级 build.gradle（位于 app 目录下），是构建动作的真正执行者：

android { namespace 'com.example.myfirstapp' compileSdk 36 defaultConfig { applicationId "com.example.myfirstapp" minSdk 24 targetSdk 36 versionCode 1 versionName "1.0" } buildTypes { release { minifyEnabled false proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro' } } }

其中compileSdk 36表示用哪个版本的 Android API 来编译，minSdk 24表示应用最低支持的安卓版本（Android 7.0），targetSdk 36表示针对 Android 16 做了适配优化。这些参数的变化会直接影响可用 API 的多寡以及应用在不同系统版本上的表现。

5.3 Gradle JDK 与构建性能调优

在 Settings - Build, Execution, Deployment - Build Tools - Gradle 中有几个关键配置项：

• Gradle JDK：指定 Gradle 运行时使用的 JDK。前面说过默认是 jbr-21，如果你有需求，可以切换为本地安装的 JDK 17。
• Build and run using：指定构建和运行的工具集，默认是 Gradle。如果你只在 Android 上折腾，保持默认即可。
• Offline work：离线模式。勾选后 Gradle 不会尝试从网络下载依赖，只使用本地缓存。如果你的项目依赖已经从缓存中完整同步过一次，在断网环境下勾选这个可以显著加快同步速度；但如果勾选了离线模式而依赖不在缓存中，构建一定会失败。

一个提升构建速度的小技巧：在项目根目录的gradle.properties文件中加上下面两行：

org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8 org.gradle.parallel=true org.gradle.caching=true

第一行是给 Gradle 进程分配 2GB 内存（根据你的机器内存调整，别超过物理内存的四分之一至三分之一），并强制文件编码为 UTF-8，防止中文乱码；第二行是启用多模块并行编译；第三行是启用构建缓存，让相同输入条件的编译任务可以复用上次结果。

5.4 Gradle Wrapper 与国内镜像源配置

Gradle Wrapper 是 Gradle 官方推荐的一种方式，它把你的项目绑定到一个特定 Gradle 版本上。好处是团队协作时所有成员使用完全一致的构建版本，不会出现“我这儿能跑你那儿不能跑”的怪问题。Wrapper 文件在项目根的gradle/wrapper/gradle-wrapper.properties中声明了版本和下载地址。

当 Gradle 发行包从官方默认地址下载缓慢时，有几个选择：一是在gradle-wrapper.properties中把distributionUrl改成国内可达的镜像地址，这是最常见的解决方案；二是使用你本机已有的 Gradle 安装版，在 Settings 中指定 “Use local gradle distribution”。

我不建议轻易修改distributionUrl，因为不同镜像的更新频率和完整性有差异。更稳妥的做法是：如果你电脑上已经装过旧版 Gradle，把下载好的gradle-x.x-bin.zip文件手动放到 Gradle 缓存目录下（Windows 为C:\Users\用户名\.gradle\wrapper\dists\gradle-8.13-bin\哈希值目录），或者直接配置gradle-wrapper.properties指向本地文件路径。这里最关键的思路是：Gradle 发行包只是一个 zip 文件，你只要能弄到这个文件，就把它放到缓存目录让 Gradle 直接使用，而不必依赖自动下载。

还有一个常见问题：“Gradle 同步成功但编译报错”。这种问题往往不是 Gradle 本身的问题，而是依赖库下载失败。依赖库的默认下载地址是 Google Maven 仓库（https://maven.google.com）和 Maven Central（https://repo.maven.apache.org）。如果你遇到依赖下载超时的报错，可以在项目级build.gradle的allprojects或 settings 文件中添加镜像仓库地址。但同样，镜像库也要谨慎挑选，有些镜像更新不及时会误报“找不到依赖”，这时候反而更难判断问题出在哪里。

6. 打包 APK 与项目移植

6.1 把项目编译成 APK 的具体流程

把 Android 项目打包成 APK 是每个开发者迟早要面对的操作。最简单的方式当然是菜单栏 Build - Build APK(s) - Build APK(s)，构建成功后右下角会弹出提示，点击 “locate” 可以在文件管理器中找到 APK 位置。

但如果你想要一个可以直接分发、签名过的 APK，就需要打开 Build - Generate Signed Bundle / APK，按向导操作：

1. 选择 APK。
2. 选择或新建一个 Key Store（签名文件）。
3. 填写 Key Alias、密码等信息。
4. 选择release构建类型。
5. 点击 Finish，等待构建完成。

签名文件（.jks文件）是应用的“身份证”，它保证了你的 APK 没有被篡改，也用于标识开发者的身份。这里有一个全网教程很少强调的要点：签名文件务必妥善备份。如果你发布了应用并使用了 A 签名文件，后来丢失了它，你将永远无法用原有包名更新这个应用。我身边就有开发者吃过这个亏，被迫换了包名重新上架。

如果你的 APK 只是用来自测或分享给朋友临时安装，不打算上架商店，那么用 Android Studio 默认的调试签名即可——它就是debug构建类型自动签名的结果。位置在Build - Build APK(s)，产物目录在app/build/outputs/apk/debug/。

6.2 从别的电脑移植 Android Studio 项目

“移植 Android Studio 项目”这一搜索词在网络上很常见，对应的场景有几种：换新电脑、从 GitHub 克隆仓库、接手同事的项目。

无论哪种场景，拿到一个项目后建议先做四件事：

1. 检查gradle-wrapper.properties中的 Gradle 版本，如果本地缓存里没有对应版本，就提前准备下载。
2. 检查build.gradle中的compileSdk和targetSdk版本，必要时在 SDK Manager 中补齐对应 Platform。
3. 检查local.properties文件（如果存在），确认sdk.dir指向你机器上的正确 SDK 路径。
4. 执行一次Build - Clean Project，然后File - Sync Project with Gradle Files。

遇到“项目导入后一同步就报错”这样的问题，报错信息里最常见的关键词之一是 “SDK location not found”。这通常意味着local.properties缺失或 SDK 路径不对。解决方法是手动创建local.properties文件并写入：

sdk.dir=D:\\Android\\Sdk

注意 Windows 路径中的反斜杠要写成双反斜杠（或者统一用正斜杠D:/Android/Sdk）。如果你是从 GitHub 上克隆的项目，这个文件一般不会包含在仓库中，需要你自己新建。

6.3 旧的第三方项目与新版 IDE 的兼容性处理

这一节专门写给那些被迫维护老项目的同学。Android Studio 2026 版在处理 2020 年前后的项目时基本是“向下兼容”的，但偶尔会出现 AGP 版本过旧而无法在当前 IDE 中运行的情况。

例如你打开一个 2019 年的项目，它使用的是 AGP 3.3.2 和 Gradle 4.10.1。在新版 IDE 中，IDE 会尝试用自身内置的较新版 Gradle 去解析这个项目，但由于 AGP 和 Gradle 的版本矩阵不匹配，很可能直接报错 “Minimum supported Gradle version is X” 或者干脆同步失败。

此时的办法，就是升级项目中的 AGP 和 Gradle 版本。具体操作是编辑gradle-wrapper.properties的distributionUrl，把 Gradle 升到一个与新版 AGP 兼容的版本，同时修改项目级build.gradle中的 AGP 版本号。升级后大概率还会遇到一堆 API 变更导致的代码报错，比如 HTTP 请求方式改变、存储权限变化等。这里给一个参考版本组合，是我实测比较稳定的搭配：

如果你的项目升级跨度很大，建议一步步来，先升一个版本，同步成功后整理报错，再继续升下一个版本。一步跨太多，报错会变得非常难定位。

7. 安装配置中的常见问题与排查技巧

7.1 常见报错速查表

按出现频率从高到低，我把这几年用户在安装配置中遇到的最典型的报错信息整理了一下：

7.2 下载卡住、同步失败怎么快速定位

Gradle 同步失败是所有新手首先会遇到的高频问题。你可以按这个顺序自查：

第一步，看左下角 “Build” 面板里有没有红色的错误信息。如果错误是 “Could not resolve all dependencies”，那基本就是依赖下载失败了。

第二步，看具体是哪个依赖下载失败。报错信息里会列出库的 groupId 和 artifactId，例如com.android.support:appcompat-v7:28.0.0。把库名复制去搜索引擎，能很快确认它来自 Google Maven 还是 Maven Central。

第三步，检查你当前的网络状况。如果网络不通畅，就去配置仓库镜像。但正如我前面所说，镜像用起来省事，却也容易让人忽略根因。从根本上解决依赖下载慢，最好还是配置一个稳定可靠且合法的网络下发直接访问的方案。

还有一个被忽视的排查点：检查系统时间。如果系统时间和实际时间差太多，HTTPS 请求会因证书验证失败而中断。别笑，我在公司真遇到过一次，新装的电脑系统时间差了一天，导致所有依赖下载全部失败，折腾了两个小时才发现。

7.3 关于“安装不成功”的最终手段

如果你试了上面的所有方案，Android Studio 仍然安装不成功或无法正常构建，那么最终手段就是“彻底清理重装”。很多情况下，之前的版本残留会干扰新版的正常工作，这一点在 Windows 上尤其常见。

清理步骤如下：

1. 卸载 Android Studio 本体。
2. 删除配置目录：
   • Windows：C:\Users\用户名\.android、C:\Users\用户名\.gradle、C:\Users\用户名\AppData\Local\Google\AndroidStudioX.X（版本号对应的目录）。
   • macOS：~/.android、~/.gradle、~/Library/Application Support/Google/AndroidStudioX.X。
3. 删除 SDK 目录（如果确定不需要保留已有的系统镜像和下载缓存）。
4. 重新按照第 1 节到第 5 节的顺序安装和配置。

这一套流程下来，90% 以上的“疑难杂症”都能根治。不过请千万注意：清理之前，备份你的签名文件（.jks）、local.properties以及项目中特殊定制的gradle.properties配置。这些丢了比装不上下一个 IDE 更难受。

8. 最后想分享的经验

装一遍 Android Studio 其实不难，绝大部分人的挫败感都来自“缺一个中间步骤”或“某个组件版本不匹配”。我自己从 2016 年第一次接触 Android 开发到今天，至少完整安装配置过不下二十遍，最大的体会是：不要只盯着“下一步”按钮，要学会看日志、理解构建过程的角色分工。

一个小建议：遇到问题先分清楚是“网络问题”“版本问题”还是“配置问题”。网络问题看下载速度、看超时信息；版本问题看 AGP、Gradle、JDK 三者的匹配关系；配置问题看路径、环境变量和文件内容。把这三类问题分开对待，大多数安装配置的坑都能在几分钟内定位清楚。

还有一个长期受用的习惯：每年新版本发布后，如果你没有特定需求，不要急着升级大版本。等第一个修复补丁发布、社区反馈稳定了再升级，能避免不少折腾。Android Studio 是开发工具，不是追新工具，稳定的工作流比什么都重要。

最后再提一句，如果你身边也有朋友正在被 Android Studio 的安装折磨，你可以把这篇教程转发给他。记得提醒他：“看到 Build 面板出现 BUILD SUCCESSFUL 之前，任何一步卡住都不要慌，按着第 7 节的速查表对号入座就行。”愿你第一次启动就顺利跑通，少走我当年走过的弯路。