Android SDK 安装指南（MacOS 和 Windows）

玉梅小洋2026-02-06 8:40

Android SDK 安装指南（MacOS 和 Windows）

你需要在对应开发环境（Windows 或 macOS 13.2.1）上安装 Android SDK ，核心需求是完成环境配置、适配跨平台/App开发、后续能正常编译Android项目 。Android SDK 有两种安装方式：「通过Android Studio自动安装（推荐，新手友好，无需手动配置）」和「手动下载安装（适合有经验开发者，灵活定制）」，下面详细讲解步骤，兼顾你的 macOS 13.2.1 和 Windows 环境。

一、 推荐方案：通过 Android Studio 自动安装（优先选择）

Android Studio 会自动管理 Android SDK 的下载、更新和环境变量配置，还能适配后续的 Gradle、模拟器等工具，是新手和团队开发的最优选择。

步骤 1：下载并安装 Android Studio

  1. 访问 Android Studio 官方下载页，下载对应系统版本（macOS 或 Windows）。

    • macOS 13.2.1：下载 Mac with Apple Chip（M1/M2/M3）或 Mac with Intel Chip 版本。

    • Windows：下载 Windows (64-bit) 版本（需提前安装 .NET Framework 4.8 和 Visual Studio Build Tools）。

  2. 安装流程（下一步式操作，无特殊配置）：

    • macOS：双击 .dmg 文件，将 Android Studio 拖拽到「应用程序」文件夹，启动后按提示完成初始化。

    • Windows：双击 .exe 文件，勾选「Android Studio」和「Android Virtual Device」（模拟器，可选），一路下一步完成安装。

步骤 2：初始化 Android Studio 并安装 SDK

  1. 首次启动 Android Studio，会弹出「Android Studio Setup Wizard」（设置向导），选择「Standard」（标准安装，推荐新手），点击「Next」。

  2. 选择界面主题（默认 Darcula 深色主题，可按需切换），点击「Next」。

  3. 确认 SDK 安装路径（默认路径无需修改，避免中文/空格路径）：

    • macOS：/Users/你的用户名/Library/Android/sdk

    • Windows：C:\Users\你的用户名\AppData\Local\Android\Sdk

  4. 点击「Next」，Android Studio 会自动下载并安装：

    • Android SDK 核心包（最新稳定版，如 Android 14 (API 34)）

    • SDK Tools（如 Gradle、Build Tools 等）

    • 可选：Android 模拟器（若需本地调试 App）

  5. 等待下载完成（网络不佳可配置国内镜像，见下文「优化技巧」），点击「Finish」完成初始化。

步骤 3：验证 SDK 安装成功

  1. 打开 Android Studio，进入「File → Settings → Appearance & Behavior → System Settings → Android SDK」（macOS 为「Android Studio → Settings → Android SDK」）。

  2. 在「SDK Platforms」标签页，可看到已安装的 Android 版本（如 API 34），勾选状态为「已安装」。

  3. 在「SDK Tools」标签页，可看到「Android SDK Build-Tools」「Android SDK Platform-Tools」「Gradle」等工具已安装，说明 SDK 安装完成。

二、 备选方案：手动下载安装 Android SDK（无 Android Studio 场景）

若你仅需 SDK 无需 Android Studio（如仅用于 Flutter/React Native 跨平台开发），可手动下载安装，核心是「下载 SDK 包 + 配置环境变量」。

步骤 1：下载 Android SDK 工具包

  1. 访问 Android 开发者官网 SDK 下载页，下滑到「Command line tools only」，下载对应系统版本的命令行工具包：

    • macOS：commandlinetools-mac-xxx_latest.zip

    • Windows：commandlinetools-win-xxx_latest.zip

  2. 解压下载的压缩包，创建一个专门存放 Android SDK 的目录（避免中文/空格路径）：

    • macOS：mkdir -p ~/Android/Sdk（解压到 ~/Android/Sdk/cmdline-tools/ 目录下）

    • Windows：创建 C:\Android\Sdk，解压到 C:\Android\Sdk\cmdline-tools\ 目录下

步骤 2：通过命令行安装 SDK 核心组件

  1. 打开终端（macOS）或命令提示符（Windows），进入 cmdline-tools 的 bin 目录：

    • macOS：cd ~/Android/Sdk/cmdline-tools/latest/bin

    • Windows：cd C:\Android\Sdk\cmdline-tools\latest\bin

  2. 执行命令查看可安装的 SDK 组件：

    Bash 复制代码 
    # macOS/Linux
./sdkmanager --list

# Windows
sdkmanager --list

  3. 安装核心 SDK 组件（必须安装：平台工具、构建工具、最新 Android 平台）：

    Bash 复制代码 
    # 通用命令（安装 API 34 核心组件，可替换为其他 API 版本）
# macOS/Linux
./sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0"

# Windows
sdkmanager "platforms;android-34" "platform-tools" "build-tools;34.0.0"

  4. 等待下载完成（需同意许可协议，输入 y 确认），核心 SDK 组件会自动安装到对应目录。

步骤 3：配置环境变量（关键，否则命令行无法识别 SDK）

macOS 13.2.1 环境变量配置

  1. 打开终端，编辑 bash 或 zsh 配置文件（根据你的终端类型选择）：

    Bash 复制代码 
    # 若使用 zsh（macOS 默认终端）
open ~/.zshrc

# 若使用 bash
open ~/.bash_profile

  2. 在配置文件末尾追加以下内容（替换为你的 SDK 实际路径）：

    Bash 复制代码 
    # Android SDK 根目录
export ANDROID_HOME=~/Android/Sdk
# platform-tools 目录（包含 adb、fastboot 等工具）
export PATH=$PATH:$ANDROID_HOME/platform-tools
# cmdline-tools bin 目录
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin
# build-tools 目录
export PATH=$PATH:$ANDROID_HOME/build-tools/34.0.0

  3. 保存文件，执行命令使配置生效：

    Bash 复制代码 
    # zsh 终端
source ~/.zshrc

# bash 终端
source ~/.bash_profile
Windows 环境变量配置

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。

  2. 在「用户变量」中，点击「新建」，创建变量 ANDROID_HOME，值为 SDK 根目录（如 C:\Android\Sdk）。

  3. 编辑「用户变量」中的 Path，添加以下 3 个路径：

    • %ANDROID_HOME%\platform-tools

    • %ANDROID_HOME%\cmdline-tools\latest\bin

    • %ANDROID_HOME%\build-tools\34.0.0

  4. 点击「确定」保存所有配置，关闭并重新打开命令提示符。

步骤 4：验证手动安装成功

打开终端/命令提示符，执行以下命令，若能输出版本信息，说明安装并配置成功：

Bash 复制代码 
# 验证 adb 工具（平台工具）
adb --version

# 验证 sdkmanager 工具（命令行工具）
sdkmanager --version

三、 关键优化技巧（避坑+提速）

  1. 配置国内镜像（解决下载缓慢）

由于 Android SDK 资源托管在海外，国内下载缓慢，可配置阿里云镜像：

  • 打开 Android Studio →「Settings → System Settings → Android SDK → SDK Update Sites」。

  • 点击「Add」，添加以下镜像地址，勾选启用，取消默认官方地址：

    Plain 复制代码 
    平台镜像：https://mirrors.aliyun.com/android/repository/sdk-tools/latest/
通用镜像：https://mirrors.aliyun.com/android/repository/

  • 手动安装时，可通过 sdkmanager 指定镜像：

    Bash 复制代码 
    sdkmanager --sdk_root=~/Android/Sdk --repository=https://mirrors.aliyun.com/android/repository/ "platforms;android-34"
  1. 避免中文/空格路径

SDK 安装目录和项目目录均不可包含中文、空格或特殊字符，否则会导致 Gradle 编译失败、adb 无法识别设备等问题。

  1. 安装对应版本的 Build Tools

不同 Android 项目对 Build Tools 版本有要求，可在 Android Studio 中按需安装（「SDK Tools → 勾选对应 Build Tools 版本」）。

  1. 更新 SDK 组件

定期通过 Android Studio 或 sdkmanager --update 命令更新 SDK 组件，修复已知 Bug，提升兼容性。

四、 常见问题排查

  1. adb 命令未找到 ：环境变量配置错误，重新检查 ANDROID_HOME 和 Path 路径是否正确，重启终端。

  2. 下载失败/超时：网络问题，配置国内镜像，或切换稳定网络（如手机热点）。

  3. 权限不足（macOS） ：执行 chmod +x 赋予工具执行权限，如 chmod +x ~/Android/Sdk/platform-tools/adb。

  4. Windows 缺少 .NET Framework：下载并安装 .NET Framework 4.8，重启电脑后重新安装。

总结

  1. 新手优先选择Android Studio 自动安装，无需手动配置，高效避坑，适配后续跨平台开发（Flutter/React Native）。

  2. 无 Android Studio 需求时，可选择手动下载安装，核心是「解压包 + 安装核心组件 + 配置环境变量」。

  3. 关键要点：配置国内镜像提速、避免中文路径、验证 adb 和 sdkmanager 命令确保安装成功。

按以上步骤操作后，即可完成 Android SDK 的安装和配置，后续可正常进行 Android 项目开发或跨平台 App 的 Android 端编译。

相关推荐
美酒没故事°16 小时前
Open WebUI安装指南。搭建自己的自托管 AI 平台
人工智能·windows·ai
BoomHe16 小时前
Android AOSP13 原生 Launcher3 壁纸获取方式
android
Digitally17 小时前
如何将联系人从 Android 转移到 Android
android
一个欠登儿程序员18 小时前
在国产服务器上通过 Docker 部署 Windows 虚拟机
服务器·windows·docker
李小枫18 小时前
webflux接收application/x-www-form-urlencoded参数
android·java·开发语言
爱丽_18 小时前
MySQL `EXPLAIN`：看懂执行计划、判断索引是否生效与排错套路
android·数据库·mysql
NPE~18 小时前
[App逆向]环境搭建下篇 — — 逆向源码+hook实战
android·javascript·python·教程·逆向·hook·逆向分析
爱宇阳19 小时前
WSL2 隔离 Windows PATH 实战指南
windows·环境变量
ALex_zry19 小时前
C++模板元编程实战技巧
网络·c++·windows
I疯子19 小时前
2026-04-08 打卡第 5 天
开发语言·windows·python
热门推荐
01GitHub 镜像站点02一周AI热点速览（2026.03.31-04.06）：GPT-6曝光、谷歌开源Gemma 4、资本狂飙与模型军备竞赛03OpenClaw 请求超时 llm request timed out 怎么解决？3 种方案实测，附完整排查流程04AI 编程效率翻倍：Superpowers Skills 上手清单 + 完整指南05VMware Workstation Pro 17 虚拟机完整安装教程（2026最新）06Qwen3.5-Omni与Qwen3.6模型全面解析（含测评/案例/使用教程）07Oh My Codex 快速使用指南08UV安装并设置国内源09Claude Code 未登录 使用第三方模型10实测！Gemma 4 成功跑在安卓手机上：离线 AI 助手终于来了