如何在 macOS 中构建适合移动开发的基础环境-Mac OS-PHP中文网

macos移动开发基础环境需安装xcode（≥15.4）及命令行工具、homebrew、jdk 11/17、git与github cli；ios侧配置xcode路径、cocoapods；android侧安装platform-tools、sdk命令行工具并设android_home；辅以zsh增强、nvm管理node、vs code插件支持。

在 macos 上构建适合移动开发的基础环境，核心是打通 ios 和 android 两端的编译、调试与模拟能力，同时确保底层工具链稳定、路径清晰、版本可控。这不是装几个软件就行，而是建立一套可复用、易维护、少冲突的工作底座。

必备系统级组件安装

这是所有移动开发的前提，跳过或简化会导致后续大量报错：

Xcode 及其命令行工具：从 App Store 安装最新版 Xcode（2026 年建议 ≥ 15.4），启动后进入 Preferences → Locations，确认 Command Line Tools 已选中；再终端执行 xcode-select --install 补全 CLI 工具集。
Homebrew：运行官网一键命令安装（如 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"），它将作为后续绝大多数开发工具的安装中枢。

Java JDK（11 或 17）：Android 构建链强依赖 Java。推荐用 Homebrew 安装：brew install openjdk@17，然后在 ~/.zshrc 中添加：

export JAVA_HOME=$(/opt/homebrew/opt/openjdk@17/bin/java -XshowSettings:properties -version 2>&1 > /dev/null | grep "java.home" | cut -d "=" -f 2 | tr -d ' ')

Git 与 GitHub CLI：Homebrew 一键安装：brew install git gh，登录 gh auth login 后可直接管理仓库和 PR。

iOS 开发专项配置

重点在于让终端真正“认得” Xcode 的 SDK 和工具：

macOS Automator Services

部署和使用军舰的 macOS Automator 自动化服务集合。包含 5 个实用工作流：PDF转JPG、PNG重命名并转JPG、图像拼接、解压RAR、顺序命名图像文件。一键安装所有服务到 ~/Library/Services/ 目录。使用场景：(1) "安装我的自动化服务"，(2) "部署所有 Automato...

下载

在 ~/.zshrc 中追加 Xcode 工具链路径：
export PATH="/Applications/Xcode.app/Contents/Developer/usr/bin:$PATH"
执行 source ~/.zshrc 生效后，运行 xcrun simctl list 应能列出可用模拟器。
安装 CocoaPods（iOS 依赖管理）：sudo gem install cocoapods 或更推荐 brew install cocoapods（避免 Ruby 权限问题）。
首次运行 pod setup 较慢，建议挂代理或使用国内镜像源（如清华源）加速。

Android 开发基础就位

无需立即安装完整 Android Studio，先配通命令行构建能力：

用 Homebrew 安装 Android SDK 命令行工具：brew install android-platform-tools，它提供 adb、fastboot 等关键命令。
手动下载 Android SDK Command-line Tools，解压后配置环境变量：
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$ANDROID_HOME/platform-tools:$PATH
运行 sdkmanager --list 验证是否可访问 SDK 包列表；常用包如：
sdkmanager "platforms;android-34" "build-tools;34.0.0" "emulator"

统一开发体验增强项

提升日常效率，避免重复劳动：

终端与 Shell：确认当前为 zsh（echo $SHELL），用 oh-my-zsh 或 starship 美化提示符，加装 zsh-autosuggestions 提升命令输入效率。
Node.js 管理：用 nvm（curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash）管理多版本 Node，React Native、Flutter 等框架对版本敏感。
IDE 支持准备：VS Code 推荐安装 Swift、Debugger for iOS、Android ADB 插件；如用 JetBrains 系列，可通过 brew install --cask jetbrains-toolbox 统一管理。