2025最终！Mac配置Flutter全平台开发环境完整指南（亲测有效）

💡 本文记录了我在 Mac（Apple Silicon）上从零配置 Flutter 开发环境的完整过程，包括 iOS、Android、Web、macOS 全平台支持，踩过的坑和解决方案全部整理在这里了。

我的环境

💻 MacBook Air M4
🖥️ macOS 15.7.2
🎯 目标：配置支持 iOS、Android、Web、macOS 的完整 Flutter 开发环境

第一步：安装 Dart

虽然 Flutter 自带 Dart，但我还是先装了独立的 Dart SDK。如果你只想用 Flutter，这步可以跳过。

我用的是 Homebrew 安装，最简单：

bash 复制代码

# 先装 Homebrew（如果你已经有了就跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装 Dart
brew tap dart-lang/dart
brew install dart

# 检查是否安装成功
dart --version

第二步：配置国内镜像（重要！）

⚠️ 这步千万别跳过，不然后面下载会慢到怀疑人生。

我在国内，必须先配置镜像源才能正常使用：

bash 复制代码

# 打开配置文件（我用的 zsh）
nano ~/.zshrc

# 在文件末尾添加这两行（清华镜像）
export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub
export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter

# 保存（Ctrl+O 然后回车，Ctrl+X 退出）

# 让配置生效
source ~/.zshrc

第三步：安装 Flutter

我试过的两种方法

方法一：Homebrew 安装（我第一次试的）

css 复制代码

brew install --cask flutter

结果遇到了这个错误：

vbnet 复制代码

curl: (35) Recv failure: Connection reset by peer
Error: Download failed on Cask 'flutter'

原因是 Homebrew 要从 Google 的服务器下载，国内访问不了。

方法二：从国内镜像手动安装（成功了！）

既然 Homebrew 不行，我就手动从清华镜像克隆：

bash 复制代码

# 1. 创建一个专门放开发工具的目录
mkdir -p ~/development
cd ~/development

# 2. 从清华镜像克隆 Flutter（速度飞快）
git clone https://mirrors.tuna.tsinghua.edu.cn/git/flutter-sdk.git flutter -b stable

# 3. 把 Flutter 添加到 PATH
nano ~/.zshrc

# 在文件末尾添加这行
export PATH="$PATH:$HOME/development/flutter/bin"

# 保存并使配置生效
source ~/.zshrc

# 4. 验证安装
flutter --version

成功输出版本号了！

第四步：运行健康检查

复制代码

flutter doctor

这命令会检查你的开发环境，我第一次运行时输出了一堆问题：

css 复制代码

[!] Flutter - Downloaded executables cannot execute on host
[✗] Android toolchain - Unable to locate Android SDK
[!] Xcode - CocoaPods not installed
[✓] Chrome - develop for the web

别慌，接下来一个个解决。

第五步：配置 iOS/macOS 开发环境

5.1 安装 Rosetta（M 系列芯片必装）

我的 Mac 是 M4 芯片，需要装这个：

css 复制代码

sudo softwareupdate --install-rosetta --agree-to-license

等几分钟，装好后 Flutter 的第一个警告就消失了。

5.2 安装 Xcode

从 App Store 搜索 Xcode 直接安装，大概 10 多个 G，我下了快一个小时😅

装好后运行这些命令：

csharp 复制代码

# 设置命令行工具路径
sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

# 首次配置
sudo xcodebuild -runFirstLaunch

# 接受许可
sudo xcodebuild -license accept

5.3 升级 Ruby

这里我踩了个大坑！Mac 自带的 Ruby 是 2.6 版本，太老了，装 CocoaPods 会报错：

arduino 复制代码

securerandom requires Ruby version >= 3.1.0

我是这样解决的：

bash 复制代码

# 用 Homebrew 安装新版 Ruby
brew install ruby

# 配置 PATH（让系统优先用新版）
nano ~/.zshrc

# 添加这两行（注意版本号可能不一样，看你装的版本）
export PATH="/opt/homebrew/opt/ruby/bin:$PATH"
export PATH="/opt/homebrew/lib/ruby/gems/3.4.0/bin:$PATH"

# 保存并生效
source ~/.zshrc

# 验证（应该显示 3.x 版本）
ruby -v

5.4 安装 CocoaPods

Ruby 升级好后，CocoaPods 就能装了：

复制代码

sudo gem install cocoapods

看到 34 gems installed 就成功了。

但我又遇到一个问题：pod 命令找不到！

bash 复制代码

pod --version
# zsh: command not found: pod

原来是 PATH 没配对。我这样解决的：

bash 复制代码

# 查看 gem 的可执行文件在哪
gem environment | grep "EXECUTABLE DIRECTORY"

# 我的输出是：/opt/homebrew/lib/ruby/gems/3.4.0/bin
# 把这个路径加到 PATH（前面 Ruby 配置时已经加过了）

# 重新加载配置
source ~/.zshrc

# 再试一次
pod --version
# 1.16.2 ✓

完美！

5.5 测试 iOS 环境

bash 复制代码

# 打开 iOS 模拟器
open -a Simulator

# 创建测试项目
flutter create my_first_app
cd my_first_app

# 运行
flutter run

看到应用在模拟器里跑起来了，激动！🎉

第六步：配置 Android 开发环境

6.1 下载安装 Android Studio

访问 developer.android.com/studio 下载 Mac 版本。

我选的是 "Standard" 安装，会自动下载 SDK 和模拟器，又是好几个 G...

6.2 安装命令行工具

在 Android Studio 里：

打开 Settings → Appearance & Behavior → System Settings → Android SDK
切到 SDK Tools 标签
勾选这几个：
- Android SDK Command-line Tools
- Android SDK Platform-Tools
- Android SDK Build-Tools
点 Apply 等下载完成

6.3 配置环境变量

bash 复制代码

nano ~/.zshrc

# 添加这些（路径根据你的实际情况调整）
export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/emulator
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/cmdline-tools/latest/bin

source ~/.zshrc

6.4 接受 Android 许可

css 复制代码

flutter doctor --android-licenses

一路按 y 就行。

6.5 创建虚拟设备

在 Android Studio：

Tools → Device Manager
Create Device
选个设备（我选的 Pixel 7）
选系统镜像（我用的最新版）
Finish

6.6 测试 Android 环境

bash 复制代码

cd my_first_app

# 先在 Device Manager 里启动虚拟设备

# 运行应用
flutter run

又成功了！📱

第七步：配置 Web 开发环境

这个最简单，装个 Chrome 就行：

arduino 复制代码

# 启用 Web 支持
flutter config --enable-web

# 在 Chrome 中运行
flutter run -d chrome

浏览器里直接看到应用了，真方便！

最终验证

再跑一次健康检查：

复制代码

flutter doctor

我的输出：

css 复制代码

[✓] Flutter (Channel stable, 3.35.7)
[✓] Android toolchain
[✓] Xcode - develop for iOS and macOS
[✓] Chrome - develop for the web
[✓] Android Studio
[✓] VS Code
[✓] IntelliJ IDEA
[✓] Connected device
[✓] Network resources

• No issues found!

全绿！终于搞定了！✨

我踩过的坑总结

坑 1：网络问题

❌ 问题：Homebrew 安装 Flutter 失败 ✅ 解决：配置国内镜像 + 手动 git clone

坑 2：Ruby 版本过低

❌ 问题：CocoaPods 安装报错 requires Ruby version >= 3.1.0 ✅ 解决：用 Homebrew 安装新版 Ruby，配置好 PATH

坑 3：pod 命令找不到

❌ 问题：zsh: command not found: pod ✅ 解决：把 gem 的 bin 目录添加到 PATH

坑 4：M 系列芯片兼容性

❌ 问题：Downloaded executables cannot execute on host ✅ 解决：安装 Rosetta

开发工具推荐

我用的是 VS Code，装了这几个扩展：

Flutter - 官方插件
Dart - 语言支持
Flutter Widget Snippets - 代码片段

在 VS Code 里按 Cmd+Shift+X 搜索安装就行。

写在最后

整个过程大概花了我 3 个小时（主要是下载时间😂），但配置完成后真的很爽，一套环境可以开发 iOS、Android、Web、macOS 全平台应用。

希望这篇文章能帮你少踩点坑！如果遇到问题，欢迎评论区交流。

下一步学习资源：

官方中文文档：flutter.cn/docs
官方 Cookbook：flutter.dev/docs/cookbo...
Codelabs 教程：flutter.dev/docs/get-st...

Happy coding! 🚀

📝 本文基于 2025年11月的最新环境编写，Flutter 版本 3.35.7

常见问题 FAQ

Q：我是 Intel 芯片的 Mac，配置有什么不同吗？ A：基本流程一样，只是不需要安装 Rosetta，Flutter 会直接运行。

Q：Android Studio 太大了，可以不装吗？ A：如果不开发 Android 应用，可以不装。只开发 iOS/Web 的话，VS Code 就够了。

Q：国内镜像有其他选择吗？ A：可以用 Flutter 中国官方镜像：

arduino 复制代码

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

Q：如何更新 Flutter？ A：运行 flutter upgrade 即可更新到最新版本。

你在配置过程中遇到了什么问题，欢迎评论区吐槽！

原本移步个人博客