Android SDK 安装指南（MacOS 和 Windows）

访问 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）。

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

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

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

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

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

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

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

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

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

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

• SDK Tools（如 Gradle、Build Tools 等）

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

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

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

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

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

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

• macOS：commandlinetools-mac-xxx_latest.zip

• Windows：commandlinetools-win-xxx_latest.zip

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

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

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

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

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

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

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

# macOS/Linux
./sdkmanager –list

# Windows
sdkmanager –list

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

# 通用命令（安装 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"

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

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

# 若使用 zsh（macOS 默认终端）
open ~/.zshrc

# 若使用 bash
open ~/.bash_profile

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

# 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

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

# zsh 终端
source ~/.zshrc

# bash 终端
source ~/.bash_profile

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

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

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

• %ANDROID_HOME%\\platform-tools

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

• %ANDROID_HOME%\\build-tools\\34.0.0

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

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

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

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

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

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

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

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