企业官网建设流程全解析

简介：Android Studio Chipmunk（2021.2.1.10）Windows 版安装包，面向 Android 应用开发者、移动端学习者及需要搭建原生开发环境的技术人员，用于在 Windows 平台完成 IDE 部署与项目调试。压缩包共约 2000 个文件，整体约 944.82MB，以 jar 库、py 脚本、json 配置、ttf/otf 字体、webp/png 资源、dll 与 exe 可执行组件为主，另含 license、xml、bat、so 等运行与授权文件，覆盖 IDE 核心运行库、构建工具链、模拟器组件及 Kotlin 相关支持，目录结构完整，解压即可使用。目前已有 427 人学习下载。该版本属于花栗鼠系列，介于 Bumblebee 与 Dolphin 之间，适合需要特定版本兼容旧项目或对照版本排序选择安装包的读者，可省去逐一下载依赖与配置环境的繁琐过程，快速进入编码与调试环节。

1. Android Studio Chipmunk 到底是个什么版本：从 2021.2.1.10 这个包名说起

如果你手里正好有一个android-studio-2021.2.1.10-windows.zip，第一反应大概率是：这串数字到底对应哪个版本，能不能直接解压就用，和官网现在推的版本差多少。先把结论说清楚——2021.2.1是 IntelliJ 平台的版本号，Android Studio 从 Arctic Fox 之后改用这套编号，Chipmunk 就是2021.2.1这一代的产品代号，后面的.10是这一代里的补丁序号。也就是说，这个 zip 是 Chipmunk 分支的一个较晚的修复版本，不是最新版，但也不是远古版本。

它解决的核心问题很具体：给还在维护老项目、或者机器配置一般、又不想被新版本各种索引和插件折腾的人，提供一个相对稳定的 IDE 环境。适合谁？适合手上有一批 Gradle 插件版本偏旧、AGP 还在 7.0 附近徘徊的工程；也适合刚入门、跟着老教程学 Android 的人，因为教程截图和菜单路径能对得上。这一章不铺开讲，后面几章会把下载校验、解压启动、SDK 配置、国内网络下的依赖拉取、以及几个高频翻车点逐个拆开。

2. 拿到 zip 之后先别急着双击：校验、解压与目录结构

2.1 为什么 zip 版比 exe 安装版更值得留一份

Android Studio 官方一直提供两种分发形式：Windows 下是.exe安装包，以及跨平台的.zip压缩包。很多人习惯性点 exe，一路下一步，结果装完发现 C 盘被塞了几十个 G，想换盘还得卸载重来。zip 版的好处是绿色、可迁移、可多版本共存——你解压到D:\dev\android-studio-chipmunk，整个 IDE 就在这个目录里，配置默认写在用户目录，想删就删，想留旧版本做对照就再解压一份到别的路径。

我一般会这么干：把 zip 解压到非系统盘，路径里不要有中文和空格。中文路径在 Windows 上对 Gradle、NDK、CMake 这些工具链是经典雷区，报错信息还特别隐晦，能避就避。

2.2 校验压缩包完整性

下载来源五花八门的时候，先确认文件没坏。Windows 自带certutil就能算哈希：

certutil -hashfile android-studio-2021.2.1.10-windows.zip SHA256

把输出和你下载页面给出的 SHA-256 对一下。对不上就别解压了，八成是传输中断或者被中间层改过。这一步看着多余，但解压到一半报 CRC 错误、或者启动时缺 dll，回头排查的成本远高于这十秒钟。

2.3 解压后的目录长什么样

解压完，根目录下大致是这些：

bin/studio64.exe是 64 位启动入口，现在基本只用这个。bin/studio.exe是 32 位遗留，机器内存小于 4G 才可能用到，正常忽略。

提示：解压工具建议用 7-Zip 或系统自带资源管理器。某些第三方压缩软件对长路径支持不好，解压到一半会丢文件，表现为启动时报Cannot find main class。

2.4 首次启动前的两个环境变量

在启动之前，先把ANDROID_HOME和JAVA_HOME想清楚。Chipmunk 自带 JBR，IDE 本身不依赖你系统的 JDK，但 Gradle 构建会。常见做法是单独装一个 JDK 11 或 17，把JAVA_HOME指过去，别让 IDE 的 JBR 和构建 JDK 混在一起。ANDROID_HOME指向你打算放 SDK 的目录，比如D:\android\sdk，第一次启动向导会让你选，提前想好省得后面迁移。

3. 启动、SDK 配置与第一个工程的落地步骤

3.1 首次启动向导里那几个选项怎么选

双击studio64.exe，第一次会走 Setup Wizard。几个关键选择：

• 安装类型选 Custom，别选 Standard。Standard 会默认把 SDK 装到C:\Users\你\AppData\Local\Android\Sdk，C 盘小的直接爆。
• SDK 位置指到你准备好的目录，比如D:\android\sdk。
• 勾选组件时，至少要有Android SDK Platform、Android SDK Build-Tools、Android SDK Platform-Tools、Android SDK Command-line Tools。Emulator 和 HAXM 看你是否用模拟器，用真机调试可以先不装。

向导走完，SDK 目录下会出现platforms/、build-tools/、platform-tools/等子目录。platform-tools里的adb.exe后面会反复用到。

3.2 国内网络下 Gradle 依赖拉不动的处理

这是 Chipmunk 时代最集中的痛点。新建工程后第一次 Sync，Gradle 要去services.gradle.org下发行包，还要去 Google 和 Maven Central 拉依赖，国内直连经常卡在Downloading或者超时。

处理分两层。第一层是 Gradle 发行包本身，改gradle/wrapper/gradle-wrapper.properties：

distributionBase=GRADLE_USER_HOME distributionPath=wrapper/dists # 换成国内可访问的镜像地址，版本号要和原文件一致 distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-7.3.3-bin.zip zipStoreBase=GRADLE_USER_HOME zipStorePath=wrapper/dists

注意distributionUrl里的版本号必须和原来一致，Chipmunk 配套的 AGP 7.2 一般对应 Gradle 7.3.3 左右，改错版本会直接报不兼容。

第二层是依赖仓库，改项目根目录的settings.gradle：

dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { // 国内镜像放前面，官方源兜底 maven { url 'https://maven.aliyun.com/repository/google' } maven { url 'https://maven.aliyun.com/repository/public' } google() mavenCentral() } }

改完点 Sync，如果还卡，看右下角进度条停在哪个域名，针对性再补镜像。别一次性把能想到的镜像全塞进去，仓库顺序会影响解析速度，镜像放前面、官方兜底就够了。

3.3 建一个最小工程验证工具链

Sync 通过后，新建一个 Empty Activity 工程，包名随便，语言选 Java 或 Kotlin 都行。点绿色三角跑起来，如果能在真机或模拟器上看到界面，说明 IDE、SDK、Gradle、adb 这条链路是通的。

跑不起来时按这个顺序看：

1. Build窗口有没有编译错误，先解决代码层面的。
2. Build面板切到Build Output，看 Gradle 任务卡在哪一步。
3. 命令行进到工程目录，执行./gradlew assembleDebug，把 IDE 的封装剥掉，错误信息更原始。
4. 设备连不上，adb devices看列表，空的就检查驱动和 USB 调试授权。

注意：Chipmunk 对 JDK 版本比较敏感，AGP 7.2 配 JDK 11 最稳。用 JDK 17 有时能跑，但个别插件会报Unsupported class file major version，遇到就换回 11。

4. 避坑与排查：Chipmunk 上最容易翻车的五件事

4.1 启动直接闪退，日志里是 JVM 相关报错

现象：双击studio64.exe，窗口一闪就没了，或者弹一个Failed to create JVM。

原因：多半是bin/studio64.exe.vmoptions里的内存参数超过了机器实际可用内存，或者你手动改过这个文件。另一个可能是系统环境变量里有个老版本JAVA_TOOL_OPTIONS在捣乱。

解决：先看%USERPROFILE%\AppData\Local\Google\AndroidStudio2021.2\log\idea.log，里面会有具体堆栈。内存参数改小，-Xmx从默认的 2048m 降到 1536m 试试。环境变量里如果有JAVA_TOOL_OPTIONS或_JAVA_OPTIONS，临时清掉再启动。

4.2 Sync 报Could not resolve但网络明明是通的

现象：依赖下载失败，报某个 group 找不到，但浏览器能打开对应仓库。

原因：Gradle 走了系统代理设置，或者gradle.properties里残留了旧的代理配置。Chipmunk 会读%USERPROFILE%\.gradle\gradle.properties和项目里的同名文件，两处都可能藏配置。

解决：检查这两个文件里有没有systemProp.http.proxyHost之类的行，不需要就删掉。如果公司网络必须走代理，确认代理地址和端口写对，并且nonProxyHosts里排除了localhost。

4.3 中文乱码，尤其是日志和注释

现象：Gradle 输出里中文变成问号或方块，代码文件里的中文注释显示异常。

原因：文件编码和 IDE 编码不一致。Windows 默认可能是 GBK，而工程文件是 UTF-8。

解决：File→Settings→Editor→File Encodings，把 Global、Project、Default 三处都设成 UTF-8，勾上Transparent native-to-ascii conversion。另外在Help→Edit Custom VM Options里加一行-Dfile.encoding=UTF-8，让 JVM 也用 UTF-8。

4.4 模拟器起不来，报 HAXM 或 Hyper-V 冲突

现象：创建 AVD 后点启动，模拟器黑屏或者直接报HAXM is not installed。

原因：Windows 上 Hyper-V、WSL2、Docker 都会占用虚拟化层，和 Intel HAXM 冲突。Chipmunk 时代的模拟器对这种情况处理得不算好。

解决：要么在 BIOS 里确认虚拟化开启，然后装对应版本的 HAXM；要么干脆放弃 HAXM，用 Windows Hypervisor Platform。最省事的办法是用真机调试，USB 连上，adb devices认到就能跑，绕开模拟器这一堆事。

4.5 升级或换版本后工程打不开

现象：用 Chipmunk 打开一个更高版本创建的工程，提示This project uses Android Gradle plugin version X, which is not supported。

原因：AGP 版本和 IDE 版本有对应关系，高版本工程降级打开经常不兼容。

解决：改工程根目录build.gradle里的 AGP 版本，降到 Chipmunk 支持的 7.2 附近，同时把gradle-wrapper.properties里的 Gradle 版本也降到匹配值。改之前先提交一次代码，改崩了能回退。这就是为什么我建议一个机器上留两份 IDE，新旧工程分开打开，省得来回改配置。

5. 把 Chipmunk 用顺手：几个能省时间的进阶习惯

5.1 用命令行工具补 IDE 的短板

Chipmunk 的图形界面在批量操作上不如命令行。SDK 目录下的cmdline-tools装好后，可以这样管理组件：

# 列出已安装和可用的包 sdkmanager --list # 只装指定版本的 build-tools，避免 IDE 里勾选一堆用不上的 sdkmanager "build-tools;33.0.2" "platforms;android-33" # 接受许可，批量装的时候不用一个个点 yes | sdkmanager --licenses

sdkmanager的路径在cmdline-tools/latest/bin/下，把它加到 PATH 里，以后装 SDK 组件不用开 IDE。参数上，包名必须和--list里显示的完全一致，大小写和分号都不能错，写错了会提示Warning: Failed to find package。

5.2 用gradlew而不是 IDE 按钮做构建验证

IDE 的 Build 按钮会做增量、会缓存，有时候报错信息被吞。真正要确认一个工程能不能构建，我习惯在工程根目录跑：

# Windows 下用 gradlew.bat，Linux/macOS 用 ./gradlew gradlew.bat assembleDebug --stacktrace --info

--stacktrace打出完整调用栈，--info打出更多过程日志。CI 上也是这套命令，本地和线上行为一致，能提前发现只在干净环境暴露的问题。第一次跑会下载依赖，慢是正常的，第二次就快了。

5.3 配置备份与多版本共存

Chipmunk 的用户配置在%APPDATA%\Google\AndroidStudio2021.2，插件、快捷键、代码风格都在里面。换机器或者重装前，把这个目录拷走，新环境启动前放回去，省得重新配一遍。

多版本共存的做法是：每个版本解压到独立目录，用不同的idea.properties指定不同的配置和系统目录。在bin/idea.properties里改这两行：

idea.config.path=D:/dev/as-config/chipmunk/config idea.system.path=D:/dev/as-config/chipmunk/system

这样两个版本的缓存和配置互不干扰，想删哪个直接删目录。血泪经验是别让两个版本共用同一个 system 目录，索引会互相覆盖，表现为打开工程后代码提示全乱。

5.4 一个判断值不值得继续用的标准

Chipmunk 不是最新版，官方支持周期也过了。判断它值不值得留在你机器上，看两点：一是你手上的工程 AGP 版本是否还在 7.2 附近，二是你是否需要频繁对照老教程。如果两个都是，留着它当专用环境很划算；如果工程已经升到 AGP 8.x，硬用 Chipmunk 只会天天和版本报错打架，不如直接换新版。

我自己机器上长期留着两三个 Android Studio 版本，Chipmunk 是其中一个，专门用来开那批老工程。每次新版本出来先不急着全量迁移，等工程依赖跟上了再动。这个习惯帮我省了很多回滚的时间，也希望帮到你。

本文还有配套的精品资源，点击获取