很多朋友第一次接触 Android 开发，最先卡住的地方往往不是代码，而是环境搭建这一步。Android Studio 的安装过程看起来就是“下一步、下一步”，但实际上牵扯到 JDK 版本、SDK 目录、系统变量、模拟器性能这些细节，任何一个地方出了问题，轻则启动失败，重则项目跑不起来。这篇文章我从头到尾把安装过程中的关键环节、常见报错、以及新手最容易踩的坑捋一遍，尤其是“打不开”和“创建 values”这两个高频问题，会单独拿出来讲清楚。
1. 安装前的准备工作，比安装本身更重要
1.1 确认系统环境：内存和磁盘是硬指标
Android Studio 本身是个大型 IDE，它不光是编辑代码，背后还挂着 Gradle 构建工具、SDK 管理器、模拟器（Emulator），这些组件对资源的消耗比普通软件大得多。我见过不少人在 4GB 内存的旧笔记本上装完 Android Studio，启动就要好几分钟，新建项目之后直接卡死，最后误以为是安装出了问题，其实是硬件扛不住。
给出一个参考配置，大家可以对着自己的电脑判断一下：
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Windows 10 64位 / macOS 10.14+ / Linux 64位 | Windows 11 或最新版 macOS |
| 内存 | 8GB | 16GB 及以上 |
| 磁盘空间 | 8GB 可用空间 | 至少 30GB（SDK 和 AVD 很占空间） |
| 屏幕分辨率 | 1280x800 | 1920x1080 及以上 |
| JDK | 自带 OpenJDK 17 | 使用自带 JDK，不必单独安装 |
这里特别说一句：磁盘空间是最容易被低估的。很多人以为 Android Studio 装完只占几个 GB，实际上光是一个 system-images 的模拟器镜像就要 2~4GB，你创建两三个不同 Android 版本的 AVD 之后，三五个 GB 就没了。再加上 Gradle 缓存、依赖包缓存，30GB 是个非常保守的数字。
1.2 JDK 要不要自己装？先搞清楚版本关系
Java Development Kit（JDK）是 Android 开发的基础运行环境。好消息是，Android Studio 从 2020.3.1 版本（Arctic Fox）开始就自带了 OpenJDK，安装目录下可以找到jbr文件夹，打开之后你会发现里面就是一个完整的 JRE 环境。也就是说，大多数情况下你不值得单独去装 Oracle JDK。
但有一个例外：如果你要用命令行方式执行 Gradle 构建，或者你的系统里已经存在较老版本的 JDK（比如 JDK 8），那么注意环境变量JAVA_HOME一定要指向 JDK 17 或更高版本。Android Studio 官方推荐的 Gradle 版本和 AGP（Android Gradle Plugin）版本都需要 JDK 17 支持，你如果JAVA_HOME还是 JDK 8，很可能在同步项目的时候报出类似这样一段错误：
Unsupported class file major version 61这个错误就是 JDK 版本过低、无法识别高版本字节码导致的。遇到这种问题不要慌，直接用 Android Studio 内置的 JBR 就好，在执行 Gradle 命令时加上：
export JAVA_HOME=/Applications/Android Studio.app/Contents/jbr/Contents/HomeWindows 下的路径就是 Android Studio 安装目录下的jbr文件夹。这个技巧虽然看起来简单，但能治好很多人项目同步失败的老毛病。
1.3 下载渠道和版本选择
下载 Android Studio 请务必认准官方地址：https://developer.android.com/studio。如果你在官网下载速度很慢，可以用官方提供的中国地区镜像站，或者使用国内一些知名高校、云厂商提供的镜像。这里提一个容易踩的坑：很多非官方渠道下载的“破解版”“优化版”，本质上就是旧版本套壳，甚至可能被植入广告程序。Android Studio 本身是免费软件，没有破解的必要，直接用官方版就够了。
版本选择建议：选 Stable（稳定版）而不是 Canary 或 Beta。稳定版可能不是最新，但它经过充分测试，配套的 Gradle 版本、Gradle Plugin 版本都有完善的兼容矩阵。想追求新特性完全可以等稳定版更新，没必要拿开发环境赌在测试版上。
2. 安装流程逐步拆解：Windows 和 macOS 双平台操作
2.1 Windows 安装的完整过程
双击下载好的.exe安装包，Android Studio 会先加载安装向导。三个关键选项要特别注意：
第一，安装路径。默认安装在C:\Program Files\Android\Android Studio。我的建议是保持默认，或者改到其他分区，但路径中绝对不能包含中文或空格，比如说D:\AndroidStudio是安全的，D:\软件\开发工具\Android Studio这种就非常危险。因为 SDK、Gradle 以及很多底层工具都是基于命令行工作的，路径里带中文会导致编码问题，带空格则需要额外处理引号，后面项目多了很容易出怪问题。
第二，选择组件时，Android Virtual Device选项建议勾选。这东西就是模拟器，后面运行项目全靠它，没有勾选的话你还得手动通过 SDK Manager 再装，浪费时间。
第三，安装过程中会去下载 SDK 组件，这一阶段可能是整个安装过程中最漫长的部分。SDK 下载困难的本质是组件托管在 Google 的服务器上，高峰期速度堪忧。解决方案是配置镜像源，后面我会专门讲。
安装完成后点击 Finish，首次启动才会进入真正的“解压和初始化”阶段。
2.2 macOS 安装的细节
macOS 下的安装相对简单，直接下载.dmg文件后打开，把 Android Studio 图标拖入 Applications 文件夹。这里有一个很多人忽略的操作：拖入 Applications 后，第一次启动前把 Applications 里的 Android Studio 图标移到别处再移回来（或者直接右键“打开”一次）。因为网上下载的 dmg 应用会被 Gatekeeper 标记为“从互联网下载”，直接双击会出现“无法打开，因为无法验证开发者”的警告。右键选择“打开”，再在弹出的对话框中点击“打开”，就可以绕过这个拦截。
macOS 下如果你用的是 Apple Silicon（M1、M2、M3 芯片），Android Studio 的下载页会自动提供 Apple Silicon 版本，不需要 Rosetta 转译。不过要注意：部分旧版本 Android Studio 里的某些工具链可能还是 x86 架构的，如果你在 M 系列芯片上运行模拟器遇到启动失败，可以检查 AVD 的架构是否为arm64-v8a，而不是x86_64。
2.3 自定义安装选项怎么选：Install Type 详解
安装向导里会有一个 Install Type 选项，默认是 Standard（标准安装），它包含 Android Studio、Android SDK、SDK Platform、Performance（Intel HAXM 或 Hyper-V）等组件。Advanced（自定义）则允许你手动调整组件和路径。
对于绝大多数人，我建议你直接选 Standard。为什么？因为自定义选项看起来自由度更高，但往往会出现“用户选了不合适的 SDK Platform”这种情况。比如只装了最高版本的 API Level，结果后面拉取旧项目时又要重新下载对应版本的 Platform，白白增加同步时间。标准安装默认会带当前推荐的 Platform-Tools 和一个最新版本的 Platform，基本够用。
如果你选择 Standard，初装之后如果项目需要其他版本的 SDK，Android Studio 会在项目同步时自动提示下载，点确认就行，不需要一开始就手动装全所有版本。
3. 首次启动和 SDK 管理器配置
3.1 启动向导到底要做什么
安装完成后的第一次启动，Android Studio 会弹出 Setup Wizard，主要做三件事：选择 UI 主题、确认 SDK 组件、创建 AVD（模拟器）。有一个高频问题就是安装完成后点击图标没有任何反应，或者一直停留在启动画面。这种情况多半是“第一次启动初始化 SDK 卡住了”，因为 Setup Wizard 其实不是检查你装了什么，而是把刚才勾选的 SDK 组件真正下载到磁盘。如果下载源速度慢，那整个界面就卡在一个进度条上，看起来像是死机。
这里有一个保命的小技巧：不要傻等。如果启动向导超过 30 分钟还卡在同一位置，直接把窗口取消，关掉程序，然后重新打开一次。因为 SDK 管理器支持断点续传，第二次启动会继续上次的下载进度，有时候重新触发下载反而能解决问题。
Windows 下如果依然打不开，尝试打开命令行，手工执行：
%ANDROID_HOME%\cmdline-tools\latest\bin\avdmanager.bat list avd如果能正常输出了类似Available Android Virtual devices的信息，说明 SDK 相关组件是好的，问题大概率出在 Android Studio 自己的配置上。这时删除缓存目录%USERPROFILE%\.android或%LOCALAPPDATA%\Google\AndroidStudio2024.x再启动，经常就能恢复。
3.2 SDK Platform 和 Build-Tools 的选择逻辑
进入 Android Studio 后打开Settings -> Languages & Frameworks -> Android SDK，你会看到几个 Tab。默认是 SDK Platforms，这个页面里列出的是各个 Android 系统版本的 API。怎么选？
我的建议是：安装一个你项目需要的最低版本，再安装一个你设备使用的版本。比如你的手机是 Android 14（API 34），那至少装一个 API 34 的 Platform；同时系统里留一个 API 26 或更低版本，方便后面跑老项目。不要全部勾选，全选大概会下载二十几个版本的 SDK Platform，几十个 GB 的磁盘空间直接没了，纯属浪费。
SDK Tools 标签页下，务必保证这三项是勾上的：
- Android SDK Build-Tools
- Android SDK Platform-Tools（这里面有 adb 命令，后面调试要用）
- Android Emulator
3.3 模拟器（AVD）的创建与配置
在 SDK Manager 里确认 SDK 组件完整后，打开Virtual Device Manager新建虚拟设备。这里会遇到第二个“打不开”的高频场景：模拟器窗口弹出后闪退，或者提示The emulator process for AVD ... has terminated。
排查步骤按顺序来：
第一步，看 Windows 功能里 Hyper-V、Windows Hypervisor Platform 是否开启。Android Studio 新版默认依赖 Windows 的虚拟化功能，如果 BIOS 里关闭了虚拟化，模拟器一定起不来。进入任务管理器 -> 性能 -> CPU，看右下角的“虚拟化”字段，如果是“已禁用”，需要进 BIOS 开启 Intel VT-x 或 AMD-V。
第二步，确认你创建的 AVD 镜像架构和宿主机架构匹配。Intel 芯片装 x86 镜像没问题，Apple Silicon 一定要选 arm64 镜像，在 Play Store 图标（带 Google APIs）和裸 AOSP 之间，我建议选 Google APIs 镜像，因为带 Play 商店的那个镜像更适合测试应用内购买场景，普通的 Google APIs 镜像已经能满足绝大部分开发需求。
第三步，模拟器出了活动沙滩、黑屏但没崩溃，考虑加显存和内存。编辑 AVD 配置，在config.ini里加上：
hw.ramSize=2048 hw.gpu.enabled=yes hw.gpu.mode=host其中hw.gpu.mode=host是决定模拟器能否正常渲染界面的关键。有些系统默认的 auto 模式反而会有兼容问题，手动指定为 host 后，很多渲染异常会消失。
4. “Android Studio 打不开”问题专项排查
4.1 启动无反应的通用排查步骤
“下载安装好了，打不开”是我在热搜关键词里看到最多的痛点。我整理一张问题速查表，以经验优先级排序：
| 现象 | 大概率原因 | 快速处理 |
|---|---|---|
| 双击图标后光标转圈，但窗口不出现 | JDK 异常 / 安装缓存损坏 | 删除.android、.AndroidStudio*配置目录后重开 |
| 启动到 Logo 页就崩溃 | 显卡驱动 / GPU 渲染问题 | 用命令行启动加参数-Djava.awt.headless=false？不对，应使用studio64.exe --disable-gpu或改 vmoptions 中渲染相关参数 |
提示Android Studio did not be installed correctly | 之前的版本残留 | 运行安装目录下uninstall.exe彻底卸载后重装 |
| 一直卡在进度条 | SDK 初始化下载失败 | 配置 SDK 镜像源，取消后重试 |
| 启动后一闪而过 | JDK 路径找不到 | Windows 设置JAVA_HOME为jbr路径 |
关于“一闪而过”，经常被误判为安装失败，多数情况其实是studio64.exe.vmoptions文件里配置的堆内存参数过大，导致 JVM 根本分配不到那么多内存。找到这个文件（位置在安装目录或配置文件目录），把-Xmx改成 2048m，大概率能恢复。
4.2 日志是唯一值得信赖的排查工具
打不开时，与其在网上反复搜，不如直接看日志。日志文件路径：
- Windows：
%USERPROFILE%\AppData\Local\Google\AndroidStudio2024.1\log - macOS：
~/Library/Logs/Google/AndroidStudio2024.1
重点看idea.log文件，里面会有明确的异常堆栈。比如看到no suitable driver found之类的字样，说明 JDBC 驱动或 JDK 存在问题；看到Can't determine type for tag，说明之前的项目元数据损坏。把日志里“第一行红色 ERROR 之前 20 行”贴到搜索引擎或社区求助，别人帮你看问题比在你不知道原因的情况下瞎试更高效。这是我这些年排障下来最深刻的体会。
4.3 命令行启动帮你绕过界面崩溃
如果图形界面确实打不开，可以用命令行方式启动，便于捕捉启动时的输出。Windows 下用命令：
cd C:\Program Files\Android\Android Studio\bin studio64.exe如果程序启动到一半崩溃，命令行窗口会有一段详细的 JVM 报错信息。有一种情况是系统 DPI 缩放导致布局渲染异常，Windows 用户在安装目录右键studio64.exe-> 属性 -> 兼容性 -> 更改高 DPI 设置，勾选“替代高 DPI 缩放行为”，缩放执行选“系统”，这个问题就能解决。
5. 安装完成后第一步：创建你的第一个 Android 项目
5.1 新建项目时几个关键选择项
看到 Android Studio 主界面正常显示后，点击New Project。选择一个 Empty Activity 模板即可，关键是下面几个参数要搞明白：
- Package name是应用唯一标识，格式要符合反域名规则，比如
com.example.myapp。不要使用数字开头或中途出现特殊符号，后面发布应用包名不能改。 - Minimum SDK指最低支持的 Android 版本，选 API 24 其实就有不错覆盖率，没必要选过低，低版本 API 意味着要多写一堆兼容代码。
- Build configuration language默认选 Kotlin DSL（也就是 build.gradle.kts）。现在用 Groovy DSL 的老项目很多，但新项目直接拥抱 Kotlin DSL 是大势所趋，两者语法不同但功能等价。
5.2 首次 Gradle 同步为什么慢，以及怎么加速
创建项目后，Android Studio 会自动执行一次 Gradle 同步，也就是把项目依赖都拉取到本地。这一步是新人劝退重灾区：进度条走一天都不动，最后报一个Could not resolve com.android.tools.build:gradle:8.2.0，翻译过来就是“依赖包下载失败”。
问题根源和 SDK 一样，还是源服务器的连接不稳定。解决方法是在项目根目录settings.gradle.kts或build.gradle里配置仓库镜像。以国内常用的阿里云镜像为例，配置如下：
pluginManagement { repositories { maven("https://maven.aliyun.com/repository/google") maven("https://maven.aliyun.com/repository/gradle-plugin") maven("https://maven.aliyun.com/repository/public") google() mavenCentral() gradlePluginPortal() } } dependencyResolutionManagement { repositories { maven("https://maven.aliyun.com/repository/google") maven("https://maven.aliyun.com/repository/public") google() mavenCentral() } }注意仓库顺序很重要。Gradle 会按照声明顺序尝试下载，把镜像仓库放到前面，能避免它先去访问原始仓库超时。不过也不要完全移除google()和mavenCentral()，有些新发布的库镜像源还没有同步，保留原始仓库当兜底更稳妥。
另外，在gradle-wrapper.properties里可以指定 Gradle 发行版下载源。默认地址是services.gradle.org/distributions，如果下载慢，可以改用腾讯或华为的镜像地址，浏览器直接下载 zip 包后手动放到 Gradle 缓存目录也是常见手段，结合你的实际情况来选即可。
5.3 跑通模拟器的第一次启动
项目同步成功后，点工具栏中的绿色三角运行按钮。Android Studio 会自动启动之前创建的 AVD，第一次冷启动可能较慢，因为要加载整个系统镜像。这里提醒一句：第一次跑应用之前，先去模拟器里把主界面划完一遍再点运行。别看这个操作不上台面，真有不少人是因为模拟器还在启动过程中就强行运行 App，结果 App 闪退误以为项目代码有问题。等模拟器完全进入桌面再运行，可以省下一个小时的排查时间。
6. values 目录与海外字符串适配：热搜词的第二层深挖
6.1 values 目录到底是什么、能放什么
“androidstudio怎么创建values其他国家翻译”其实是两个问题叠加：一是不知道哪里去找 values 目录，二是不知道多语言文件怎么建。
values 目录在app/src/main/res/values/下，它默认已经存在于每个新项目中。展开 app -> res -> values，你会看到strings.xml、colors.xml、themes.xml等文件。strings.xml里定义了应用运行所需的全部字符串资源：
<resources> <string name="app_name">猜拳大师</string> <string name="play">开始游戏</string> </resources>代码里通过R.string.play引用，而不是直接在页面里写汉字。这么做的价值在于：应用界面上的文字全部集中管理，想改文案不用一行行找代码，更重要的是它为多语言翻译提供了基础。
6.2 创建多语言 values 的正确姿势
假设应用的默认语言是简体中文，你希望国际市场用户（比如美国、日本、韩国）使用时也能看到自己熟悉的语言。你不需要复制一份 activity 页面去改文字，只需要在 res 目录下新增对应的 values 文件夹，并配上翻译后的 strings.xml。
操作路径是：右键res目录 -> New -> Android Resource Directory，在 Resource type 下拉框里选择values，然后在 Directory name 里手动输入values-en-rUS（美国英语）、values-ja-rJP（日语）、values-ko-rKR（韩语）。在新建的目录里添加strings.xml，把字符串的 name 保持一致，翻译内容换成对应语言。Android 系统会自动根据系统语言选择加载哪一套 strings.xml，这个过程由系统内部完成，不需要你在代码里写任何判断。
可以用一个生活化的类比来理解：strings.xml就像便利店的价签模板，默认语言的价签上是“可乐 3元”，英语目录的价签上是“Cola $1”，顾客走进店里，服务员会根据顾客的国籍抽出对应的价签给他看，商品本身并没有变。
6.3 从猜拳游戏案例看 string.xml 的正确用法
热搜里“androidstudio猜拳游戏”多半是新手教程里布置的小项目。猜拳游戏非常适合入门，它逻辑简单、状态少，但涉及 UI 交互、随机数、状态更新，比 HelloWorld 有营养得多。
把这个案例和多语言放在一起特别能说明问题。比如你做一个猜拳页面，界面有“出拳”“我把布”“剪刀”等文案。如果直接在代码文件里硬编码中文：
button.text = "石头"那么要支持英语，你就得在代码里写 if 判断，根据语言变量来赋值，页面里文案多了根本维护不了。而正确做法是在 layout 的 XML 文件里直接引用资源：
<Button android:id="@+id/btnRock" android:text="@string/rock" ... />切换到英文系统时，按钮自动变成“Rock”。这就是资源分离的魅力，它把人（代码）和内容（字符串）解耦，也让代码逻辑专注在猜拳的胜负判断上，而不是漫天飞舞的文案里。接下来就可以写一个纯 Kotlin 的处理逻辑：
val options = arrayOf("rock", "paper", "scissors") val userChoice = options[buttonIndex] val botChoice = options[Random.nextInt(3)] when { userChoice == botChoice -> "tie" (userChoice == "rock" && botChoice == "scissors") || (userChoice == "paper" && botChoice == "rock") || (userChoice == "scissors" && botChoice == "paper") -> "win" else -> "lose" }代码里不出现“石头”“剪刀”这些字眼，字符串资源单独管理，胜负判断逻辑里只处理抽象的选项。这个思路推广到任何项目都是通用的：业务逻辑与界面文案要保持两种生命周期，业务逻辑长期稳定，文案随时可能因为地域、运营策略而改变。
7. 安装与初始化之后的常见坑位速查
7.1 插件安装失败的兼容性问题
Android Studio 是 IDEA 平台的衍生品，支持通过Plugins市场安装插件。安装失败的常见原因不是网络问题，而是插件版本和 IDE 版本不兼容。插件市场会为不同 IDE 版本提供不同构建版本，如果你的 Android Studio 是旧版本，部分插件确实装不上。解决方案在于：定位到Settings -> Plugins，在搜索结果的版本列表中，勾选兼容旧版本的构建。
这里特别提一句：Flutter 插件是一个例外。Flutter SDK 对 Android Studio 版本要求比较严格，如果版本不匹配，插件安装成功但会提示Dart SDK is not configured。遇到这种提示，不是插件损坏，而是路径配置没做对。但这是另一个话题，先不展开。
7.2 项目同步出现依赖冲突怎么处理
依赖冲突是使用 Kotlin DS L 时更容易碰到的问题。具体表现在 build 时报错版本号不一致，例如 androidx.appcompat 的 1.6.0 与 1.6.1 同时出现在依赖树里。出现这种情况后的操作步骤：不要直接修改版本号，右键模块 -> Open Module Settings -> 在 Dependencies 里检查主版本声明里是否重复引用了同一个库的不同版本；如果找不到冲突，可以执行：
./gradlew :app:dependencies > deps.txt然后搜索->符号查看依赖树，定位是谁把旧版本传递上来的。这个排查思路比网上复制exclude语句更靠谱，因为手动排除会让依赖关系越来越复杂，不如把新版统一到真正需要的版本上。
7.3 磁盘空间爆满的隐形杀手
Android Studio 用久了你会发现磁盘空间莫名减少几十个 GB。除了前文提到的 AVD 镜像和 SDK Platform，还有一个容易被忽略的目录：Gradle 缓存。~/.gradle/wrapper/dists里存放着所有下载过的 Gradle 发行版，每换一个 Gradle 版本就会多出几百 MB，加上caches目录里的依赖缓存，清理不及时的话轻松占到 10GB 以上。清理方式是用 IDE 自带菜单File -> Invalidate Caches / Restart，或者手动删除~/.gradle/caches/下对应版本目录，下次构建会自动重建。不要让这些缓存堆到最后你不得不重装系统来腾空间。
8. 写给刚入坑的你几条实在建议
如果安装过程中你被某个环节卡住了，建议先做这件事：打开你的系统日志，把报错信息完整复制下来再搜索，大多数人搜不到答案是因为只搜“为什么打不开”这种宽泛描述，而知情的人看到精确报错信息几乎一眼就能告诉你原因。我自己从第一次安装到现在经历过 Studio 打不开、SDK 下载失败、模拟器黑屏、Gradle 提示编译不过、依赖冲突连环爆，最后总结出来的规律就一句话：报错信息里前 30 行永远是黄金线索，顺着它查，远比不断重装软件可靠。
另一个建议是装完环境的第一周，不要贪心去追最新版本和新功能。Android 开发工具链迭代非常快，但基础逻辑几十年不变：写代码的人、构建工具、运行环境。把“创建一个项目、改一个页面、跑一次模拟器”这三个动作完整地做一遍，比你收藏一百个教程都有用。我也建议大家把模拟器配置好之后，不要急着上真机调试，很多基础操作在模拟器里验证反而更安全，因为真机调试牵扯 USB 驱动、开发者选项、版本适配这些额外的坑。
在配置环境时保留一份清晰的记录是个好习惯。比如 SDK 路径、JDK 路径、你常用的 Gradle 版本，下次换电脑或者给同事配置环境的时候，照着记录一抄就能还原，能让你少走很多弯路。
文章的最后分享一个我常用的技巧：当你创建了多个项目之后，Android Studio 的启动速度会越来越慢，这是 Gradle 守护进程和索引机制的正常现象，不要怀疑安装有问题。进入Settings -> Build, Execution, Deployment -> Build Tools -> Gradle，把 Gradle JVM 的内存从默认的 2048MB 调到 4096MB，编译大型项目时会有明显好转。同时关闭不常用项目的自动索引缓存，能有效减少启动时间。整个安装配置过程说到底就是一次环境调优，把这些经验记下来，下次重装的时候你会感谢现在的自己。
