macos 上搭建安卓开发环境需五步：一、按芯片选装 android studio；二、首次启动跳过配置导入；三、sdk manager 中勾选平台工具、模拟器等组件；四、配置 android_home 及 path 环境变量并验证；五、通过 device manager 创建并启动 avd。
如果您在 macOS 系统上准备搭建安卓开发环境，但尚未完成 Android Studio 的安装与基础配置，则可能是由于安装路径选择、SDK 初始化或环境变量未正确设置所致。以下是完成该任务的具体步骤：
一、下载适配芯片架构的安装包
macOS 用户需根据设备芯片类型选择对应版本，否则可能导致启动失败或模拟器无法运行。Apple Silicon（M1/M2/M3）设备必须下载标注 “with Apple chip” 的版本；Intel 芯片设备则应选择 “with Intel chip” 版本。
1、访问官方渠道：进入 developer.android.com/studio 页面，系统将自动识别 macOS 并展示下载按钮。
2、点击下载链接后，获取 .dmg 文件，保存至「下载」文件夹。
3、打开 Finder，在「下载」中双击该 .dmg 文件。
4、将 Android Studio 图标拖拽至「应用程序」文件夹内完成安装。
二、首次启动并跳过旧配置导入
首次运行时，Android Studio 会询问是否导入先前版本的设置。对于全新安装用户，此项无历史配置可导入，直接跳过可避免路径冲突或界面异常。
1、在「启动台」中点击 Android Studio 图标启动程序。
2、弹出对话框时，选择 Do not import settings。
3、点击 OK 后，若出现数据共享提示，选择 Don't send。
4、等待初始化界面加载完毕，底部出现 Android Studio 停靠图标后，点击进入主窗口。
三、自定义安装组件并启用必要模块
Standard 安装模式默认不包含 Android Virtual Device（AVD）及部分平台工具，而 Custom 模式允许手动勾选关键组件，确保后续模拟器与构建功能可用。
1、在欢迎界面点击 Configure → SDK Manager，进入 SDK 设置页。
2、切换至 SDK Platforms 标签页，勾选最新版 Android（如 Android 14 - API 34）及 Show Package Details。
3、展开后，务必勾选：Android SDK Platform-Tools、Android SDK Build-Tools、Android Emulator、Android SDK Tools。
4、切换至 SDK Tools 标签页，勾选 Android SDK Command-line Tools (latest) 和 NDK (Side by side)（如需 JNI 开发）。
四、配置 ANDROID_HOME 环境变量
命令行工具（如 adb、sdkmanager）依赖 ANDROID_HOME 变量定位 SDK 根目录。未配置会导致终端执行失败，且部分插件无法识别 SDK 路径。
1、打开终端，执行 echo $SHELL 判断当前 shell 类型（zsh 为默认，bash 需单独确认）。
2、执行 open -e ~/.zshrc（zsh）或 open -e ~/.bash_profile（bash）打开配置文件。
3、在文件末尾添加以下四行（路径以实际 SDK 位置为准，通常为 $HOME/Library/Android/sdk）：
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/emulator
4、保存文件后，在终端执行 source ~/.zshrc（或 source ~/.bash_profile）使配置立即生效。
5、验证：输入 echo $ANDROID_HOME，应返回完整路径；输入 adb version 应显示版本号而非“command not found”。
五、创建并验证首个虚拟设备
AVD 是运行和调试应用的核心环境，其创建过程需依赖已安装的系统镜像与硬件加速支持，缺失任一环节均会导致启动失败。
1、在 Android Studio 主界面，点击右上角 Device Manager 图标（或通过 Tools → Device Manager 打开）。
2、点击 Create device，在设备列表中选择 Pixel 4 或其他推荐设备。
3、在系统镜像页，选择已下载的 x86_64 或 arm64-v8a 镜像（标注 Recommended 的优先），点击 Download 并等待完成。
4、镜像下载完成后，点击 Next，保持默认名称与存储路径，点击 Finish。
5、在设备列表中找到新建设备，点击右侧绿色三角形启动按钮，等待模拟器完全启动并显示锁屏界面即表示成功。
