刚给一台新笔记本装完 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 的版本。它与旧版相比有几个关键变化直接关系到安装配置方式内置 JBRJetBrains Runtime从 JBR 17 升级到了 JBR 21这意味着你不再需要手动配置系统 JDK 来运行 IDE 本身但 Gradle 构建过程对 JDK 版本有独立要求。SDK 平台工具platform-tools和构建工具build-tools的下载方式没变但默认 API Level 升级到了 36Android 16 的 SDK 成了标准配置。首次启动向导的流程做了简化默认勾选的 SDK 组件更少但如果你直接点“Next”跳过后面编译老项目时会提示缺少旧版 SDK 平台。Gradle 版本锁定的策略更严格2026 版默认生成的 wrapper 指向 Gradle 8.13如果你打开的是 2021 年以前的老项目大概率会遇到版本兼容性警告。这些变化决定了你在安装时不再需要像 2018 年那篇老教程一样手动去装 JDK 8 再配环境变量但同时也意味着新的坑会更隐蔽——比如 Gradle 版本冲突、AGPAndroid Gradle Plugin与 Gradle 的匹配问题。1.2 硬件和系统环境要求看到这里可能有人会觉得我在凑字数但我真遇到过在 4GB 内存的旧电脑上强行装 AS 2026 然后卡到怀疑人生的同学。直接说结论官方列出的最低要求看看就行真正能“顺畅开发”的配置大概是这样的配置项最低要求推荐配置备注操作系统Windows 10 64 位 / macOS 11Windows 11 / macOS 14不支持 32 位系统内存8 GB16 GB 或更高8GB 开模拟器会比较吃力硬盘空间8 GB 可用空间50 GB 以上 SSD系统镜像和依赖库真的很占空间屏幕分辨率1280x8001920x1080 以上界面元素较多低分辨率会很痛苦CPU任意 x86_64 处理器Intel i5/AMD R5 及以上模拟器运行吃 CPU 单核性能我个人的经验是安装目录所在分区必须留出至少 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\SdkWindows或~/Library/Android/sdkmacOS这个是默认路径不用改。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。一个合理的组件清单是这样的组件必装用途Android SDK Platform-Tools必装提供 adb 等命令行工具Android SDK Build-Tools 最新版必装编译打包Android SDK Platform对应 targetSdkVersion必装编译所需系统接口Android SDK Platform历史版本按需打开老项目时需要Android SDK Emulator需要模拟器时提供模拟器本体Google APIs 镜像需要 Google 服务时地图、推送等API调试判断自己需要哪些历史版本一个简单方法是打开项目的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 17JDK 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 - SettingsmacOS 是 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 DriverAEHD它可以在 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 构建插件AGPorg.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.0targetSdk 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.encodingUTF-8 org.gradle.paralleltrue org.gradle.cachingtrue第一行是给 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 Centralhttps://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按向导操作选择 APK。选择或新建一个 Key Store签名文件。填写 Key Alias、密码等信息。选择release构建类型。点击 Finish等待构建完成。签名文件.jks文件是应用的“身份证”它保证了你的 APK 没有被篡改也用于标识开发者的身份。这里有一个全网教程很少强调的要点签名文件务必妥善备份。如果你发布了应用并使用了 A 签名文件后来丢失了它你将永远无法用原有包名更新这个应用。我身边就有开发者吃过这个亏被迫换了包名重新上架。如果你的 APK 只是用来自测或分享给朋友临时安装不打算上架商店那么用 Android Studio 默认的调试签名即可——它就是debug构建类型自动签名的结果。位置在Build - Build APK(s)产物目录在app/build/outputs/apk/debug/。6.2 从别的电脑移植 Android Studio 项目“移植 Android Studio 项目”这一搜索词在网络上很常见对应的场景有几种换新电脑、从 GitHub 克隆仓库、接手同事的项目。无论哪种场景拿到一个项目后建议先做四件事检查gradle-wrapper.properties中的 Gradle 版本如果本地缓存里没有对应版本就提前准备下载。检查build.gradle中的compileSdk和targetSdk版本必要时在 SDK Manager 中补齐对应 Platform。检查local.properties文件如果存在确认sdk.dir指向你机器上的正确 SDK 路径。执行一次Build - Clean Project然后File - Sync Project with Gradle Files。遇到“项目导入后一同步就报错”这样的问题报错信息里最常见的关键词之一是 “SDK location not found”。这通常意味着local.properties缺失或 SDK 路径不对。解决方法是手动创建local.properties文件并写入sdk.dirD:\\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 请求方式改变、存储权限变化等。这里给一个参考版本组合是我实测比较稳定的搭配AGP 版本Gradle 最低版本适配的 Android Studio8.7.x8.92024.2 及以上8.6.x8.72024.1 及以上8.5.x8.72024.1 及以上8.2.x8.22023.2 及以上7.4.x7.52023.1 及以上如果你的项目升级跨度很大建议一步步来先升一个版本同步成功后整理报错再继续升下一个版本。一步跨太多报错会变得非常难定位。7. 安装配置中的常见问题与排查技巧7.1 常见报错速查表按出现频率从高到低我把这几年用户在安装配置中遇到的最典型的报错信息整理了一下报错信息可能原因解决思路SDK location not foundlocal.properties缺失或路径不对手写sdk.dir指向 SDK 路径Failed to find target with hash string android-XX缺少对应版本的 SDK Platform在 SDK Manager 中安装制定版本Could not download gradle-xxx-bin.zipGradle 发行包下载被墙/超时使用镜像或本地文件填充缓存目录Failed to install unknown package某些第三方源映射失败还原 SDK Update Sites 配置AVD 启动时卡在 “Waiting for target device to come online”系统镜像损坏或硬件加速不可用删除并重建 AVD安装对应加速组件Connection refused / 端口占用adb 服务端口 5037 被占用执行adb kill-server后重试模拟器启动但黑屏未开启硬件加速或显卡驱动问题确认 AEHD / Hypervisor 已启用编译时报错 “Unsupported class file major version 65”编译 JDK 版本过高将 Gradle JDK 切回 JDK 177.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 上尤其常见。清理步骤如下卸载 Android Studio 本体。删除配置目录WindowsC:\Users\用户名\.android、C:\Users\用户名\.gradle、C:\Users\用户名\AppData\Local\Google\AndroidStudioX.X版本号对应的目录。macOS~/.android、~/.gradle、~/Library/Application Support/Google/AndroidStudioX.X。删除 SDK 目录如果确定不需要保留已有的系统镜像和下载缓存。重新按照第 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 节的速查表对号入座就行。”愿你第一次启动就顺利跑通少走我当年走过的弯路。