三亩地 三亩地SAN MU DI · CODE DIARY
交流投稿
ARTICLE DETAIL

日记详情

真实记录编程学习的某一天，欢迎挑你感兴趣的翻一翻。

首页/学习日记/日记详情

Android Studio 2021.1.1 稳定版安装与配置全指南：从环境搭建到高效开发

发布时间：2026/8/11 9:17:00 三亩地 编程学习日记
Android Studio 2021.1.1 稳定版安装与配置全指南：从环境搭建到高效开发

1. 从零开始：为什么2021版依然值得一装？

如果你刚接触安卓开发，或者手头的Android Studio版本已经老旧到连Gradle都编译不动了，那么花点时间安装一个稳定、经典的版本，远比盲目追新要明智得多。Android Studio 2021版，具体来说，我指的是2021.1.1（Arctic Fox）这个长期支持版本，它恰好卡在一个非常舒服的技术节点上：它完美支持了当时主流的AGP（Android Gradle Plugin）7.0+和Gradle 7.x，对Kotlin协程、Compose 1.0的初期支持也相当稳定，同时又不像更早的版本那样对新的JDK或SDK兼容性不佳。最关键的是，它的UI和核心构建系统已经非常成熟，网上针对这个版本的排错资料也最全，对于新手来说，踩坑的概率会低很多。

很多人一上来就找最新版，结果被各种预览版的不稳定、插件不兼容、构建缓存莫名其妙报错搞得焦头烂额。我的建议是，学习阶段，用一个经过市场长期检验的稳定版作为起点，把精力集中在学习安卓开发本身，而不是和IDE的怪问题作斗争。今天，我就带你完整走一遍Android Studio 2021.1.1的下载、安装和关键配置，我会把那些官方文档里一笔带过、但实际安装时一定会卡住你的细节，以及我这些年积累下来的“保平安”配置技巧，都揉碎了讲清楚。

2. 安装前的关键准备：避开环境冲突的深坑

安装Android Studio不是简单地双击安装包，前期的环境清理和规划直接决定了你后续开发的顺畅程度。这一步做不好，后面“Gradle构建失败”、“SDK目录不可写”之类的问题会层出不穷。

2.1 彻底清理旧版本残留

如果你电脑上曾经装过任何版本的Android Studio或IntelliJ IDEA（特别是社区版），必须先进行彻底清理。很多人直接安装新版本，导致新旧配置混杂，引发各种灵异问题。

首先，卸载旧版的Android Studio。在Windows上，通过“设置->应用”找到并卸载。但这只是第一步，更关键的是删除残留的配置文件和缓存，它们通常藏在用户目录下：

  • Windows:C:\Users\[你的用户名]\AppData\Roaming\Google\AndroidStudio2021.1和C:\Users\[你的用户名]\AppData\Local\Google\AndroidStudio2021.1
  • macOS:~/Library/Application Support/Google/AndroidStudio2021.1和~/Library/Caches/Google/AndroidStudio2021.1以及~/Library/Logs/Google/AndroidStudio2021.1
  • Linux:~/.config/Google/AndroidStudio2021.1和~/.cache/Google/AndroidStudio2021.1

把这些目录整个删掉。如果你不确定之前装的是什么版本，可以把所有包含AndroidStudio字样的目录都浏览一遍，将非当前需要的版本目录移除。

2.2 JDK的选择与安装：别用IDE自带的

Android Studio 2021.1.1自带的是JDK 11（JetBrains Runtime）。对于大多数开发来说，这足够了。但我强烈建议你单独安装一个Oracle JDK 11或OpenJDK 11，并配置系统环境变量。原因有三点：第一，单独安装的JDK路径清晰，当你需要为终端命令行或其他构建工具（如Gradle Wrapper）指定JDK时，不会混淆；第二，避免IDE升级时自带的JDK被覆盖或更改，导致项目编译环境突变；第三，有些老旧的企业项目或第三方库对特定的JDK发行版有要求，独立JDK更灵活。

去Oracle官网或Adoptium（Eclipse Temurin）网站下载JDK 11的安装包，安装到一个简单的路径，比如C:\Java\jdk-11或/Library/Java/JavaVirtualMachines/jdk-11.jdk。然后设置系统环境变量JAVA_HOME指向这个目录，并把%JAVA_HOME%\bin（Windows）或$JAVA_HOME/bin（macOS/Linux）添加到PATH变量中。完成后，在命令行输入java -version和javac -version验证是否是你刚安装的版本。

2.3 规划好SDK和项目的“家”

这是最重要的一步，直接影响未来的磁盘空间和项目管理。Android SDK、Gradle全局缓存、以及你的项目文件，都非常占用空间。绝对不要使用默认的C盘路径！

我建议在空间充裕的非系统盘（如D盘）创建以下目录结构：

D:\AndroidDev\ ├── AndroidSDK\ # 存放Android SDK ├── AndroidProjects\ # 存放你的所有项目源码 └── GradleCache\ # 后续配置Gradle全局缓存用

在macOS或Linux上，类似，可以在~/Development/目录下创建。提前创建好AndroidSDK目录，因为在安装向导中，Android Studio会问你SDK的安装位置，这时你就可以直接指向这个预先创建好的空目录，而不是让它装到C盘的用户目录下。这样做的好处是，未来重装系统、更换电脑，或者需要多版本Android Studio共享同一套SDK时，迁移和备份都非常方便。

3. 分步安装详解与首次运行向导避坑指南

准备好之后，我们开始正式安装。从Android Studio官网的存档页面或可信的镜像站下载android-studio-2021.1.1.x-windows.exe（或其他平台对应版本）。运行安装程序。

3.1 安装过程中的关键选项

安装过程大部分可以“下一步”，但有几个选项需要留意：

  1. 安装类型：选择“Custom”，这样可以在下一步选择JDK路径。虽然我们准备了独立的JDK，但这里还是让安装程序把它自带的JBR装上，作为IDE运行时的后备。
  2. 选择组件：确保“Android Virtual Device”（安卓虚拟设备）被选中，除非你确定只用真机调试。虽然模拟器比较吃资源，但测试时必不可少。
  3. 安装路径：将Android Studio本体安装到非系统盘，例如D:\Program Files\Android\Android Studio 2021.1.1\。
  4. 开始菜单文件夹：默认即可。

安装完成后，先不要急着启动。如果你在Windows上，以管理员身份运行一次Android Studio的启动程序（右键->以管理员身份运行），这有助于它完成一些需要权限的初始化操作，比如创建一些系统链接。之后就可以正常启动了。

3.2 首次运行向导：决定开发体验的配置

首次启动会进入设置向导（Setup Wizard）。这里每一步都至关重要。

第一步：导入旧设置。如果是全新安装，选择“Do not import settings”。

第二步：安装类型。选“Custom”，让我们能详细配置。

第三步：JDK路径确认。这里显示的是IDE自带的JDK路径，不用改。我们之前配置的系统JAVA_HOME是为构建系统准备的。

第四步：UI主题。根据喜好选择Darcula（深色）或Light（浅色），深色对眼睛更友好。

第五步：Android SDK安装位置。这是关键！点击“Android SDK Location”后面的输入框，选择我们之前规划好的D:\AndroidDev\AndroidSDK目录。安装程序会自动检测该目录是否为空，如果是空的，它会下载SDK到这里。如果目录已有SDK，它会尝试复用。

第六步：SDK组件选择。这里会下载具体的SDK版本和工具。对于新手，我建议：

  • Android SDK版本：至少勾选一个最新的稳定版（当时是API 30或31）和一个市场占有率高的版本（如API 28）。这能保证你既能测试新特性，又能兼容大部分设备。
  • 性能优化必选项：
    • Android SDK Build-Tools：确保选中最高版本（如30.0.3）。构建工具是编译APK的核心。
    • Android SDK Platform-Tools：必须勾选，包含adb、fastboot等关键调试工具。
    • Android SDK Tools (Obsolete)：这个旧工具集可以不选，除非你有特殊需要。
    • Android Emulator：如果你打算用模拟器，务必勾选。它会下载Intel HAXM（Intel CPU）或Apple Hypervisor（Apple Silicon Mac）等硬件加速驱动，这是模拟器流畅运行的关键。
    • Android SDK Command-line Tools (latest)：强烈建议勾选。它提供了sdkmanager等命令行工具，对于通过脚本管理SDK或CI/CD环境非常有用。

点击“Finish”后，IDE会开始下载所选组件。这是一个漫长的过程，速度取决于你的网络。强烈建议开启全局代理（如果具备合法合规的网络访问条件）或使用国内镜像源来加速。你可以在开始下载前，点击“Cancel”退出向导，先配置代理。

3.3 配置SDK管理器镜像源（大幅提升下载速度）

由于网络原因，直接从Google服务器下载SDK可能极慢甚至失败。我们需要配置国内镜像源。

如果你在上一步取消了下载，或者在后续使用中需要更新SDK，可以手动打开SDK Manager。在启动后的IDE欢迎界面，点击右下角的“Configure -> SDK Manager”。或者在未来任何项目界面，点击菜单栏“File -> Settings -> Appearance & Behavior -> System Settings -> Android SDK”。

在SDK Manager窗口中，点击“SDK Tools”选项卡。这里列出了所有可安装的工具。但我们需要先改源。

关闭SDK Manager，回到欢迎界面。我们需要修改Android SDK的更新站点配置。找到你的SDK目录（D:\AndroidDev\AndroidSDK），进入tools\bin子目录，找到sdkmanager.bat（Windows）或sdkmanager（macOS/Linux）文件。

在这个目录打开命令行（Windows可按住Shift右键，选择“在此处打开PowerShell窗口”）。但更一劳永逸的方法是直接修改配置文件。在SDK根目录下，找到或创建repositories.cfg文件。然后用文本编辑器打开SDK目录下的tools\bin目录里的sdkmanager脚本（或查看其帮助），不过对于GUI操作，更简单的方法是设置环境变量。

实际上，对于Android Studio 2021，最有效的方法是在启动IDE前设置HTTP代理，或者在SDK Manager的界面上直接配置。但国内镜像源更稳定。以配置“东软信息学院”镜像为例（请在使用前确认其当前可用性）：

  1. 打开Android Studio，进入“File -> Settings -> Appearance & Behavior -> System Settings -> HTTP Proxy”。
  2. 选择“Manual proxy configuration”。
  3. 在Host name中填入mirrors.neusoft.edu.cn，Port number填入80。
  4. 点击“Check connection”测试连通性，输入https://dl.google.com测试，如果显示成功，则代理有效。

另一种更底层的方法是，在用户目录下的.android文件夹（Windows:C:\Users\[用户名]\.android）中，创建一个名为repositories.cfg的文件（如果不存在），但此方法对Android Studio 2021的GUI工具影响有限，主要影响命令行sdkmanager。因此，配置HTTP代理是GUI环境下最推荐的方式。配置好代理后，重新打开SDK Manager，下载速度应该会有质的飞跃。

4. 安装后的核心环境配置与优化

SDK下载完成后，IDE会重启进入欢迎界面。先别急着创建新项目，我们需要进行几项关键的初始配置，这些配置能让你未来的开发效率提升数倍。

4.1 全局项目设置：构建速度与稳定性的基石

点击“Customize -> All settings...”进入完整的设置页面（或者以后从“File -> Settings”进入）。

1. 修改Gradle全局服务目录路径：在“Build, Execution, Deployment -> Build Tools -> Gradle”面板。

  • Gradle user home：这是Gradle下载的依赖包（Wrapper、插件、库文件）的全局缓存目录。默认在C:\Users\[用户名]\.gradle，会占用大量C盘空间。我们把它改到之前规划好的D:\AndroidDev\GradleCache。这个改动影响所有项目，能有效释放系统盘空间，并且方便备份。
  • 勾选“Offline work”要谨慎：只有在确定所有依赖都已下载完毕，且需要完全断开网络构建时才勾选。平时不要勾，否则Gradle无法检查更新。

2. 配置Android SDK路径确认：在“Appearance & Behavior -> System Settings -> Android SDK”面板。确认“Android SDK Location”指向的是我们自定义的D:\AndroidDev\AndroidSDK路径。下方应该列出了已安装的SDK Platforms和SDK Tools。

3. 修改代码字体和大小（保护视力）：在“Editor -> Font”面板。

  • Primary font：推荐使用等宽字体，如JetBrains Mono、Fira Code或Consolas。JetBrains Mono专为编程设计，连字符（ligatures）非常漂亮。
  • Size：建议设置为14-16，根据屏幕分辨率调整。
  • Line height：行高建议设为1.2或1.3，让代码看起来不那么拥挤。

4. 开启自动导包和优化导入（提升编码效率）：在“Editor -> General -> Auto Import”面板。

  • 勾选“Add unambiguous imports on the fly”（为明确无误的导入自动添加）。
  • 勾选“Optimize imports on the fly”（自动优化导入，移除无用import语句）。
  • 在“Insert imports on paste”下拉框选择“All”，这样粘贴代码时会自动询问是否导入所需的类。

4.2 插件管理：安装必备神器

Android Studio的强大离不开插件。在“Plugins”市场中，安装以下插件能极大提升开发体验：

  1. .ignore：生成和管理各种.ignore文件（如.gitignore），必备。
  2. Rainbow Brackets：给配对括号加上彩虹色，在嵌套复杂的代码中快速定位括号范围。
  3. CodeGlance：在编辑器右侧显示一个迷你代码地图，快速导航。
  4. Key Promoter X：当你用鼠标点击某个功能时，它会提示对应的快捷键，帮助你记忆并过渡到键盘流操作。
  5. JSON To Kotlin Class：将JSON字符串快速转换为Kotlin data class，对接网络接口时非常高效。
  6. Android WiFi ADB：无需USB线，通过WiFi连接手机进行调试，解放你的接口。

安装插件后通常需要重启IDE。注意，不要安装过多插件，以免影响启动和运行速度。

4.3 模拟器（AVD）创建与性能调优

虽然真机调试更快，但模拟器在测试多种屏幕尺寸和系统版本时无可替代。在欢迎界面点击“Configure -> AVD Manager”创建虚拟设备。

创建步骤：

  1. 点击“Create Virtual Device”。
  2. 选择硬件：新手建议从“Pixel”系列选一个，如Pixel 4。分辨率适中，文档丰富。
  3. 选择系统镜像：选择一个已下载的SDK版本（如API 30）。注意看“Release Name”和“API Level”。建议选择带有“Google Play”标志的版本，这样你可以测试应用内支付等Google Play服务。点击下载对应的系统镜像。
  4. AVD配置：
    • AVD Name：起个有意义的名称，如Pixel_4_API_30。
    • Graphics：这是性能关键！首选“Hardware - GLES 2.0”，它利用主机GPU渲染，性能最好。如果遇到图形问题（如黑屏），可以回退到“Software”。
    • Device Frame：勾选“Enable Device Frame”可以显示手机边框，更美观。
    • Show Advanced Settings：展开后可以设置：
      • Internal Storage：模拟器内置存储，默认即可。
      • SD Card：如果需要测试SD卡读写，可以在这里创建虚拟SD卡。
      • Camera：前后摄像头可以设置为“Emulated”或使用主机摄像头（“Webcam”）。
      • Network：保持默认。
      • Emulated Performance - Graphics: 同上，选“Hardware”。
      • Memory and Storage：RAM至少分配2048MB，4096MB更佳。VM Heap默认即可。

创建完成后，启动模拟器。第一次启动会比较慢，因为它要初始化系统。启动后，你可以在设置中开启“开发者选项”，并打开“USB调试”（虽然是无线的），以便后续连接。

注意：在Windows上，如果使用Intel CPU，确保在BIOS中开启了“Intel Virtualization Technology (VT-x)”，并且已成功安装“Intel HAXM”驱动（在SDK Manager的SDK Tools中检查）。如果使用AMD CPU，则需要Windows Hypervisor Platform和AMD的特定驱动。在Apple Silicon Mac上，则使用内置的Apple Hypervisor，无需额外配置。

5. 创建第一个项目与Gradle构建深度解析

环境配置妥当，我们来创建第一个项目验证一切是否正常。点击欢迎界面的“New Project”。

5.1 项目模板选择与关键参数

Android Studio提供了多种模板。对于纯粹的学习和测试，我建议选择最基础的“Empty Activity”。它生成的代码最少，干扰最小，能让你专注于构建过程本身。

在配置页面：

  • Name：项目名称，如MyFirstApp。避免使用中文和空格。
  • Package name：应用包名，通常是域名反写+应用名，如com.example.myfirstapp。这是应用的唯一标识。
  • Save location：务必指向我们规划好的项目目录，如D:\AndroidDev\AndroidProjects\MyFirstApp。再次强调，别放桌面或C盘。
  • Language：选择“Kotlin”。Kotlin已是安卓开发的官方首选语言，语法更简洁安全。
  • Minimum SDK：选择“API 21: Android 5.0 (Lollipop)”。这是一个兼顾市场覆盖率和现代特性的平衡点。过低的API会限制你使用新特性，过高的API则会减少你的潜在用户。你可以通过链接查看对应的市场占有率。
  • Use legacy android.support libraries：绝对不要勾选！这是旧的兼容库，新项目一律使用AndroidX。

点击“Finish”，IDE会开始创建项目并首次构建。这个过程会下载Gradle Wrapper和项目所需的依赖，耗时较长，状态栏会有进度提示。

5.2 理解并加速Gradle构建过程

首次构建时，你会看到底部“Build”工具窗口在疯狂输出日志。这是Gradle在干活。你需要理解几个关键文件：

  • gradle/wrapper/gradle-wrapper.properties：定义了本项目使用的Gradle版本。Android Studio 2021.1.1默认可能会用Gradle 7.0.2。这个版本与AGP 7.0+配合良好，不要随意修改。
  • 项目根目录的build.gradle.kts(或 build.gradle)：这是项目的顶级构建脚本，主要配置整个项目仓库和依赖。
  • app模块目录下的build.gradle.kts：这是主模块的构建脚本，配置应用ID、版本、依赖库等核心信息。

加速构建的实战技巧：

  1. 开启Gradle Daemon：它默认是开启的，一个常驻后台的进程，能避免每次构建都启动新的JVM，大幅提升后续构建速度。在gradle.properties文件（用户全局的或项目根目录的）中确保有org.gradle.daemon=true。
  2. 配置并行构建：在gradle.properties中添加org.gradle.parallel=true，让Gradle并行执行独立的构建任务。
  3. 增大堆内存：在gradle.properties中添加org.gradle.jvmargs=-Xmx4096m -XX:MaxMetaspaceSize=1024m，根据你电脑内存调整（如16G内存可设为-Xmx6144m）。这能给Gradle更多内存，减少垃圾回收。
  4. 启用构建缓存（重要）：在gradle.properties中添加org.gradle.caching=true。Gradle会将构建输出缓存起来，下次构建相同内容时直接复用。
  5. 使用离线模式（谨慎）：当所有依赖都下载好后，在Android Studio设置中临时勾选“Offline work”，或者在命令行构建时加上--offline参数，可以完全跳过网络检查。但一旦需要新依赖，构建就会失败。

构建成功后，你应该能在app -> src -> main -> java/kotlin/com...下看到MainActivity.kt文件，在res -> layout下看到activity_main.xml布局文件。

5.3 连接真机进行调试

模拟器毕竟有性能损耗，真机调试才是最终归宿。确保手机已开启“开发者选项”（通常是在“关于手机”中连续点击“版本号”7次），并在其中开启“USB调试”。

用USB数据线连接电脑和手机。手机上可能会弹出“允许USB调试吗？”的授权对话框，勾选“始终允许”并确定。此时，Android Studio顶部工具栏的运行设备选择框中，应该会出现你的手机型号。选择它，然后点击旁边的绿色运行按钮（或Shift+F10）。

IDE会编译应用并安装到你的手机。第一次安装可能会比较慢。成功后，你就能在手机上看到你的“Hello World!”应用了。真机调试的日志（Logcat）输出速度远快于模拟器，是开发调试的首选。

6. 高频问题排查与日常使用技巧

即使按照上述步骤操作，在实际开发中你还是会遇到各种问题。这里汇总几个高频问题及其解决方案。

6.1 Gradle构建失败：连接超时与依赖下载问题

这是最常见的问题，症状是构建时卡在Download https://dl.google.com/...或Could not resolve com.android.tools.build:gradle:7.0.2。

解决方案：

  1. 检查代理设置：确认之前在HTTP Proxy中配置的代理有效且规则正确。对于命令行构建，可能需要单独为命令行设置代理（如设置HTTP_PROXY和HTTPS_PROXY环境变量）。
  2. 使用国内仓库镜像：修改项目根目录的build.gradle.kts文件，在repositories块中添加阿里云等国内镜像源。
    // 在 allprojects 的 repositories 里，或者 buildscript 的 repositories 里添加 maven { url = uri("https://maven.aliyun.com/repository/public/") } maven { url = uri("https://maven.aliyun.com/repository/google/") } maven { url = uri("https://maven.aliyun.com/repository/gradle-plugin/") } // 记得保留原有的 google() 和 mavenCentral()，顺序上可以把镜像源放前面
  3. 手动下载依赖：对于特定的jar包下载失败，可以尝试在浏览器中打开那个URL，手动下载后放到Gradle缓存目录（Gradle user home下的caches\modules-2\files-2.1）对应路径中，但这种方法比较繁琐。
  4. 清除缓存并重试：在Android Studio中，选择“File -> Invalidate Caches and Restart...”，这是一个终极手段，能清除IDE和项目索引的缓存，解决很多玄学问题。

6.2 模拟器无法启动或启动黑屏

  1. 检查虚拟化支持：在Windows任务管理器的“性能”标签页查看“虚拟化”是否已启用。如果禁用，需要进入BIOS开启Intel VT-x或AMD-V。
  2. 检查HAXM安装：在SDK Manager的SDK Tools中，查看“Intel x86 Emulator Accelerator (HAXM installer)”是否已安装。如果没有，勾选并应用。如果安装失败，可能需要手动从Intel官网下载安装。
  3. 切换图形渲染模式：在AVD配置中，将Graphics从“Hardware”切换到“Software”或“Automatic”试试。
  4. 冷启动：关闭模拟器，在AVD Manager中对该设备选择“Cold Boot Now”，进行冷启动。
  5. 创建新的AVD：有时某个AVD镜像损坏，尝试用不同的系统镜像创建一个新的AVD。

6.3 代码提示（Auto Completion）失效或卡顿

  1. 重建索引：点击菜单栏“File -> Invalidate Caches and Restart...”，选择“Invalidate and Restart”。这是解决索引问题最有效的方法。
  2. 关闭省电模式：在“File -> Power Save Mode”查看是否意外开启了省电模式，它会禁用所有后台操作，包括代码分析和提示。
  3. 调整IDE堆内存：如果项目很大，默认的IDE内存可能不够。在Android Studio安装目录的bin文件夹下，找到studio64.exe.vmoptions文件（Windows）或studio.vmoptions（macOS），用文本编辑器打开，调整-Xms和-Xmx参数（如-Xms1024m -Xmx4096m），然后重启IDE。

6.4 日常高效使用技巧

  1. 快捷键记忆：记住几个最常用的：Shift + F10（运行）、Shift + F9（调试）、Ctrl + Shift + F（全局搜索）、Ctrl + N（查找类）、Ctrl + Shift + N（查找文件）、Alt + Enter（万能键，显示意图动作，如导包、创建方法等）。使用Key Promoter X插件来辅助学习。
  2. 快速定位：双击Shift键可以搜索任何东西（动作、类、文件、设置）。Ctrl + E显示最近打开的文件。
  3. 版本控制集成：Android Studio内置了强大的Git支持。在“VCS -> Enable Version Control Integration”中关联你的项目目录和Git，之后就可以在IDE内完成commit、push、pull、diff等所有操作，非常方便。
  4. 布局编辑器预览切换：在XML布局文件中，点击右上角的“Design”和“Code”可以切换设计和代码视图。在“Design”视图中，可以通过左上角的下拉框切换不同的设备型号、主题、日夜模式来预览效果。

安装和配置只是起点，一个稳定、高效的开发环境能让你在后续的学习和开发中如鱼得水。遇到问题别慌，大部分都是环境或网络问题，按照清晰的思路（检查代理、清理缓存、重建索引）一步步排查，总能解决。Android Studio功能庞杂，不必一开始就追求全部掌握，先从写代码、运行、调试这个核心循环开始，在实践中慢慢探索其他高级功能。

编程学习 学习日记 实战经验
← 返回列表