一、环境搭建前的准备工作

在开始安装前，建议开发者完成以下基础配置：

系统版本要求：macOS 10.14.6（Mojave）或更高版本
终端工具选择：推荐使用系统自带的Terminal或iTerm2
命令行工具：确保已安装Xcode命令行工具（通过xcode-select --install安装）
磁盘空间：预留至少5GB可用空间（Flutter SDK及相关依赖占用约3GB）

二、Dart开发环境搭建方案

方案一：通过包管理工具安装（推荐）

1. 安装Homebrew包管理器

作为macOS生态最成熟的包管理工具，Homebrew可简化后续依赖安装流程。执行以下命令完成安装：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后建议运行brew doctor检查环境健康状态。

2. 配置Dart开发环境

通过Homebrew官方仓库安装最新稳定版Dart：

brew tap dart-lang/dart
brew install dart

安装完成后验证版本信息：

dart --version
# 预期输出示例：Dart SDK version: 3.0.0 (stable)

3. 环境变量配置

将Dart的bin目录添加至PATH环境变量：

echo 'export PATH="$PATH:/usr/local/opt/dart/bin"' >> ~/.zshrc
source ~/.zshrc

对于使用bash的用户，需修改.bash_profile文件。

方案二：手动安装方式

适用于需要特定版本或离线安装的场景：

从官方托管仓库下载SDK压缩包
解压至/usr/local/opt/dart目录
手动配置环境变量（同方案一步骤3）

三、Flutter开发环境搭建方案

方案一：通过包管理工具安装

1. 安装Flutter SDK

brew install --cask flutter

此方式会自动处理依赖关系，但需注意：

首次安装可能耗时较长（约10-20分钟）
需要科学上网环境访问官方源

2. 常见问题处理

当出现curl: (35)错误时，表明网络连接被重置，此时应：

检查代理设置是否正确
考虑使用国内镜像源安装（见方案二）
验证SSL证书配置是否有效

方案二：国内镜像源安装（推荐）

1. 配置镜像加速

编辑终端配置文件（根据使用的shell类型选择）：

# zsh用户
nano ~/.zshrc
# bash用户
nano ~/.bash_profile

添加以下镜像配置（以某高校镜像站为例）：

export PUB_HOSTED_URL=https://mirrors.example.edu.cn/dart-pub
export FLUTTER_STORAGE_BASE_URL=https://mirrors.example.edu.cn/flutter

使配置立即生效：

source ~/.zshrc  # 或 source ~/.bash_profile

2. 克隆稳定版SDK

mkdir -p ~/development
cd ~/development
git clone https://mirrors.example.edu.cn/git/flutter-sdk.git flutter -b stable

此操作会下载约1.5GB的代码库，建议保持网络稳定。

3. 配置环境变量

echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.zshrc
source ~/.zshrc

4. 验证安装结果

flutter --version
# 预期输出示例：Flutter 3.10.0 • channel stable

四、开发环境完整性检查

执行flutter doctor命令进行全面诊断，典型输出应包含：

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.10.0)
[✓] Android toolchain - develop for Android devices
[✓] Xcode - develop for iOS and macOS
[✓] Chrome - develop for the web
[✓] Android Studio
[✓] Connected device (2 available)

常见问题解决方案

Android Studio未检测到：
- 安装Android Studio并配置ANDROID_HOME环境变量
- 确保Flutter插件已安装
iOS开发环境缺失：
- 安装Xcode（通过App Store）
- 运行sudo xcode-select --switch /Applications/Xcode.app
- 接受Xcode许可协议：sudo xcodebuild -license accept
命令未找到错误：
- 检查PATH环境变量配置
- 确认终端会话已重新加载配置文件

五、开发环境优化建议

版本管理：
- 使用flutter channel命令切换开发分支
- 通过flutter upgrade保持SDK更新
性能优化：
- 启用Gradle守护进程加速Android构建
- 配置Xcode构建缓存
调试工具：
- 安装DevTools进行性能分析
- 配置IDE的Flutter插件集
持续集成：
- 配置CI/CD流水线时注意环境隔离
- 使用缓存机制加速构建过程

六、进阶配置选项

1. 多版本管理

对于需要同时维护多个Flutter版本的项目，推荐使用fvm（Flutter Version Management）工具：

brew tap leoafarias/fvm
brew install fvm
fvm install 3.10.0
fvm use 3.10.0 --global

2. 企业级部署方案

在大型团队开发中，建议：

建立内部镜像仓库
标准化开发环境配置
实现自动化环境初始化脚本
配置统一的依赖管理策略

3. 跨平台开发配置

同时开发iOS和Android应用时，需注意：

配置正确的代码签名证书
统一各平台的最小SDK版本
协调不同平台的插件兼容性

通过本文介绍的完整流程，开发者可在macOS系统上快速构建稳定高效的Dart/Flutter开发环境。建议定期检查环境健康状态，及时更新SDK版本，并遵循最佳实践进行项目配置，以获得最佳开发体验。对于企业级开发团队，建议建立标准化的环境管理流程，确保团队成员开发环境的一致性。

macOS系统下Dart与Flutter开发环境搭建全攻略