Flutter是当下流行的跨平台应用开发框架，很多开发者会选择在macOS系统上进行Flutter开发。本文将详细介绍在macOS系统中搭建Flutter 3.24.3版本开发环境的具体步骤，所有操作均经过实测验证，确保流程准确可行。
前期准备
在开始搭建环境之前，需要先确认你的macOS系统满足以下要求：
- 系统版本为macOS 10.15及以上
- 已安装最新版本的Xcode
- 已安装Homebrew包管理工具
- 预留至少10GB的磁盘空间
下载Flutter 3.24.3 SDK
首先前往Flutter官方归档页面下载对应版本的SDK压缩包，下载完成后解压到你想存放的目录，比如可以将解压后的文件夹放到用户目录下的development文件夹中。
解压完成后，需要配置Flutter的环境变量，打开终端执行以下命令编辑shell配置文件：
# 如果是zsh终端，编辑~/.zshrc文件 vim ~/.zshrc # 如果是bash终端，编辑~/.bash_profile文件 vim ~/.bash_profile # 在文件末尾添加以下内容，注意替换/path/to/flutter为你的Flutter SDK实际存放路径 export PATH="/path/to/flutter/bin:$PATH" # 保存退出后执行以下命令让配置生效 source ~/.zshrc # 或者 source ~/.bash_profile
安装Dart SDK与依赖
Flutter 3.24.3版本自带对应的Dart SDK，无需单独安装，配置好Flutter环境变量后，Dart也会自动可用。接下来需要安装Flutter开发所需的依赖工具：
# 安装cocoapods，用于iOS依赖管理 sudo gem install cocoapods # 安装以下工具依赖 brew install libimobiledevice brew install ideviceinstaller brew install ios-deploy brew install cocoapods pod setup
配置开发工具
推荐使用Android Studio作为Flutter开发的IDE，安装完成后需要安装Flutter和Dart插件：
- 打开Android Studio，点击Preferences进入设置页面
- 找到Plugins选项，在Marketplace中搜索Flutter，点击Install安装
- 安装Flutter插件时会自动提示安装Dart插件，确认安装即可
- 安装完成后重启Android Studio
如果需要开发iOS应用，还需要打开Xcode，同意相关协议，同时安装Xcode命令行工具：
xcode-select --install
验证环境配置
所有配置完成后，在终端执行以下命令检查环境是否正常：
flutter doctor
该命令会检测当前环境的所有配置情况，正常情况下会显示以下信息：
| 检测项 | 状态 | 说明 |
|---|---|---|
| Flutter | 已安装 | 版本为3.24.3 |
| Dart | 已安装 | 对应Flutter自带的Dart版本 |
| Android Studio | 已安装 | 已安装Flutter和Dart插件 |
| Xcode | 已安装 | 已配置相关依赖 |
| iOS工具 | 已安装 | cocoapods等依赖正常 |
如果检测结果显示有缺失项，可以根据提示的命令进行补充安装，直到所有项都显示正常。
创建测试项目
环境验证通过后，可以创建一个测试项目确认开发环境可用：
# 创建名为test_flutter的Flutter项目 flutter create test_flutter # 进入项目目录 cd test_flutter # 运行项目，连接iOS或Android设备后可以选择对应设备运行 flutter run
如果项目能够正常编译运行，并且在设备上显示出默认的Flutter计数器应用界面，说明你的Flutter 3.24.3开发环境已经搭建成功，可以开始进行Flutter应用开发了。
常见问题解决
搭建过程中可能会遇到一些问题，以下是常见的解决办法：
- 如果
flutter doctor提示Android许可证未同意，执行flutter doctor --android-licenses，按提示输入y同意所有许可证即可 - 如果cocoapods安装失败，可以尝试更换gem源为国内源后重新安装
- 如果项目运行提示缺少依赖，可以根据终端提示执行对应的安装命令
FluttermacOS开发环境搭建DartAndroid_Studio修改时间：2026-05-31 06:10:39