嚴寒のblog

筑梦师的猫

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 安装，最简单：

# 先装 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

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

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

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

# 打开配置文件（我用的 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 安装（我第一次试的）

brew install --cask flutter

结果遇到了这个错误：

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

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

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

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

# 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

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

[!] 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 芯片，需要装这个：

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

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

5.2 安装 Xcode

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

装好后运行这些命令：

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

# 首次配置
sudo xcodebuild -runFirstLaunch

# 接受许可
sudo xcodebuild -license accept

5.3 升级 Ruby

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

securerandom requires Ruby version >= 3.1.0

我是这样解决的：

# 用 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 命令找不到！

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

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

# 查看 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 环境

# 打开 iOS 模拟器
open -a Simulator

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

# 运行
flutter run

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

第六步：配置 Android 开发环境

6.1 下载安装 Android Studio

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

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

6.2 安装命令行工具

在 Android Studio 里：

  1. 打开 Settings → Appearance & Behavior → System Settings → Android SDK

  2. 切到 SDK Tools 标签

  3. 勾选这几个：

    • Android SDK Command-line Tools

    • Android SDK Platform-Tools

    • Android SDK Build-Tools

  4. 点 Apply 等下载完成

6.3 配置环境变量

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 许可

flutter doctor --android-licenses

一路按 y 就行。

6.5 创建虚拟设备

在 Android Studio：

  1. Tools → Device Manager

  2. Create Device

  3. 选个设备（我选的 Pixel 7）

  4. 选系统镜像（我用的最新版）

  5. Finish

6.6 测试 Android 环境

cd my_first_app

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

# 运行应用
flutter run

又成功了！📱

第七步：配置 Web 开发环境

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

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

# 在 Chrome 中运行
flutter run -d chrome

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

最终验证

再跑一次健康检查：

flutter doctor

我的输出：

[✓] 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，装了这几个扩展：

  1. Flutter - 官方插件

  2. Dart - 语言支持

  3. Flutter Widget Snippets - 代码片段

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

写在最后

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

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

下一步学习资源：

  • 官方中文文档：https://flutter.cn/docs

  • 官方 Cookbook：https://flutter.dev/docs/cookbook

  • Codelabs 教程：https://flutter.dev/docs/get-started/codelab

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 中国官方镜像：

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

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

最近的文章

🧩 前言：从“只读”到“征服” 那天下午，我插上那块 5TB 的移动硬盘，Finder 一脸冷漠。文件是灰色的，右键菜单也没“删除”选项——我只能“看”，不能“动”。 那一刻，我第一次认真地理解了：macOS 对 NTFS 是只读的。 我上网一搜，“NTFS for Mac” 的结果铺天盖地，几乎…

继续阅读
更早的文章

环境说明 测试环境： 操作系统：macOS 15.7.2 (支持 macOS 10.14+) 芯片架构：Apple Silicon (M1/M2/M3/M4) Flutter 版本：3.35.7 (stable) 支持的开发平台： iOS 应用开发 macOS 应用开发 Android 应用开发 W…

继续阅读