1. Mac配置Flutter环境完整指南作为一名移动端开发者我最近在Mac上配置Flutter开发环境时踩了不少坑。这篇文章将详细记录完整的配置流程包括SDK安装、环境变量设置、IDE配置等关键步骤并分享一些实战中积累的经验技巧。Flutter是Google推出的跨平台移动应用开发框架可以同时构建iOS和Android应用。在Mac上配置Flutter环境相比Windows有一个优势可以同时进行iOS和Android开发测试。1.1 系统要求检查在开始安装前请确保你的Mac满足以下最低要求操作系统macOS 64位系统磁盘空间至少700MB可用空间不包含Xcode或Android Studio的占用命令行工具bash、mkdir、rm、git、curl、unzip、which等基本工具提示可以通过在终端运行git --version和curl --version等命令来检查这些工具是否已安装。1.2 安装Flutter SDK1.2.1 下载Flutter SDK推荐从Flutter官网下载最新稳定版的SDKcd ~/development wget https://storage.googleapis.com/flutter_infra_release/releases/stable/macos/flutter_macos_3.13.9-stable.zip unzip flutter_macos_3.13.9-stable.zip如果你在国内访问官方下载可能较慢可以使用国内镜像wget https://storage.flutter-io.cn/flutter_infra_release/releases/stable/macos/flutter_macos_3.13.9-stable.zip1.2.2 设置环境变量将Flutter添加到PATH中以便在任何终端会话中都能使用flutter命令确定Flutter SDK的解压路径例如~/development/flutter编辑bash配置文件nano ~/.bash_profile添加以下内容export PATH$PATH:$HOME/development/flutter/bin保存文件后运行source ~/.bash_profile如果你使用zsh终端还需要编辑~/.zshrc文件添加source ~/.bash_profile验证配置是否成功which flutter应该返回Flutter的可执行文件路径。1.3 运行flutter doctor这个命令会检查你的开发环境并显示报告flutter doctor首次运行时会自动下载所需的依赖项。输出结果会显示哪些工具已经安装哪些还需要配置。典型的输出可能如下[✓] Flutter (Channel stable, 3.13.9, on macOS 13.5.2 22G91 darwin-arm64, locale zh-Hans-CN) [!] Android toolchain - develop for Android devices ✗ Android licenses not accepted. To resolve this, run: flutter doctor --android-licenses [✓] Xcode - develop for iOS and macOS [✓] Chrome - develop for the web [!] Android Studio (not installed) [✓] VS Code (version 1.83.1) [✓] Connected device (1 available) [✓] Network resources1.4 安装和配置Android开发环境1.4.1 安装Android Studio从官网下载Android Studiohttps://developer.android.com/studio按照向导完成安装启动Android Studio完成初始设置向导安装Android SDK和平台工具1.4.2 配置Android工具链运行以下命令接受Android许可协议flutter doctor --android-licenses按y键接受所有许可协议。1.4.3 设置ANDROID_HOME环境变量在~/.bash_profile中添加export ANDROID_HOME$HOME/Library/Android/sdk export PATH$PATH:$ANDROID_HOME/platform-tools export PATH$PATH:$ANDROID_HOME/tools export PATH$PATH:$ANDROID_HOME/tools/bin然后运行source ~/.bash_profile1.5 配置iOS开发环境1.5.1 安装Xcode从Mac App Store安装最新版Xcode。安装完成后还需要安装命令行工具sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer sudo xcodebuild -runFirstLaunch1.5.2 接受Xcode许可协议运行以下命令sudo xcodebuild -license滚动到底部输入accept同意许可协议。1.6 IDE配置1.6.1 Android Studio插件安装启动Android Studio打开Preferences Plugins搜索并安装Flutter插件这会自动安装Dart插件重启Android Studio1.6.2 VS Code配置安装VS Codehttps://code.visualstudio.com/打开扩展市场(CmdShiftX)搜索并安装Flutter扩展重启VS Code1.7 创建第一个Flutter项目1.7.1 通过命令行创建flutter create my_first_app cd my_first_app flutter run1.7.2 通过Android Studio创建选择Start a new Flutter project选择Flutter Application输入项目名称和位置点击Finish1.7.3 通过VS Code创建打开命令面板(CmdShiftP)输入Flutter: New Project选择项目类型和位置1.8 运行应用程序1.8.1 在Android模拟器上运行启动Android Studio打开AVD Manager创建或选择一个虚拟设备启动模拟器在项目目录运行flutter run1.8.2 在iOS模拟器上运行启动模拟器open -a Simulator在项目目录运行flutter run1.8.3 在真机上运行对于Android设备启用开发者选项和USB调试通过USB连接设备运行flutter devices # 确认设备被识别 flutter run对于iOS设备使用Xcode配置开发者账号和设备连接设备并信任开发者证书运行flutter run1.9 常见问题解决1.9.1 Flutter命令找不到如果遇到flutter: command not found错误说明PATH设置不正确。检查Flutter SDK的安装路径~/.bash_profile中的PATH设置是否执行了source ~/.bash_profile1.9.2 Android许可问题如果flutter doctor显示Android许可未接受运行flutter doctor --android-licenses然后按y接受所有许可。1.9.3 iOS构建失败常见的iOS构建问题CocoaPods未安装运行sudo gem install cocoapods证书问题在Xcode中检查签名设置架构问题确保模拟器或设备架构与构建配置匹配1.9.4 国内网络问题在国内可能会遇到下载依赖慢的问题可以设置以下环境变量export PUB_HOSTED_URLhttps://pub.flutter-io.cn export FLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cn1.10 环境维护和升级1.10.1 升级Flutter SDK要升级到最新稳定版flutter upgrade1.10.2 切换Flutter渠道Flutter有以下渠道stable稳定版beta测试版dev开发版master主分支查看当前渠道flutter channel切换渠道flutter channel stable flutter upgrade1.10.3 清理和修复如果遇到奇怪的问题可以尝试flutter clean # 清理构建文件 flutter pub cache repair # 修复pub缓存1.11 开发工具和技巧1.11.1 热重载Flutter的热重载功能可以快速查看代码更改效果在终端按r键在VS Code中点击热重载按钮在Android Studio中点击闪电图标1.11.2 调试工具Flutter提供强大的调试工具Flutter Inspector检查widget树Performance Overlay性能监控Debug Paint显示布局边界1.11.3 常用命令flutter analyze # 代码分析 flutter test # 运行测试 flutter build apk # 构建Android APK flutter build ios # 构建iOS应用 flutter pub get # 获取依赖1.12 个人经验分享在实际使用中我发现以下几点特别重要保持环境更新定期运行flutter upgrade可以避免很多兼容性问题多设备测试同时在iOS和Android设备上测试尽早发现平台差异利用社区资源Flutter社区非常活跃遇到问题时Stack Overflow和GitHub Issues通常有解决方案备份Flutter SDK有时升级会导致问题保留一个稳定版本的SDK备份很有用配置过程中最常见的坑是环境变量设置不正确和许可协议未接受。务必仔细阅读flutter doctor的输出解决所有标有[!]的问题。最后Flutter的文档非常完善遇到问题时查阅官方文档https://flutter.dev/docs通常能找到答案。