2、开发环境搭建：Windows/Mac系统配置、安装Flutter SDK、配置Android Studio和Xcode

说实话，很多初学者在「环境搭建」这一步就卡住了。我见过不少朋友，下载了Flutter SDK，然后对着终端报错一脸懵。别急，今天咱们一步步来，把这条路走通。

2.1 系统要求：先看看你的电脑够不够格

Flutter对系统要求其实不高。我自己的老款MacBook Air都能跑得动。但有几个硬性条件你得满足：

  • Windows：Windows 7 SP1 或更高版本（64位）。我个人建议用Windows 10以上，省心。
  • Mac：macOS 10.14 (Mojave) 或更高版本。如果你用的是M1/M2芯片的Mac，嗯，Flutter早就完美支持了。
  • 磁盘空间：至少留出 2.8 GB（不算IDE和模拟器）。实际上你装完Android Studio和Xcode，可能得吃掉20GB+。
  • Git：Flutter依赖Git来管理依赖包。Windows用户记得装Git for Windows。
💡 我的小建议：如果你用的是Windows，尽量把路径设成纯英文。我曾经因为用户名是中文，折腾了半天环境变量，后来才发现是路径编码的问题。

2.2 安装Flutter SDK

这是最核心的一步。说白了，Flutter SDK就是一套工具链，帮你把Dart代码编译成原生应用。

2.2.1 下载Flutter SDK

去官网下载对应系统的SDK。我习惯用稳定版（stable channel），毕竟教学嘛，稳定第一。

  • Windows：下载 flutter_windows_3.x.x-stable.zip
  • Mac：下载 flutter_macos_3.x.x-stable.zip

下载后解压到一个你记得住的位置。我个人放在 C:\src\flutter（Windows）或 ~/development/flutter（Mac）。

2.2.2 配置环境变量

这一步很多人会忘。你想想看，如果不配环境变量，每次敲 flutter 命令都得输完整路径，多麻烦。

Windows 用户：

  1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中找到 Path，双击编辑
  3. 新增一条：C:\src\flutter\bin（换成你的实际路径）
  4. 确定保存，重启终端

Mac 用户：

打开终端，编辑你的 shell 配置文件（我用的 zsh，所以是 ~/.zshrc）：

export PATH="$PATH:$HOME/development/flutter/bin"

然后执行 source ~/.zshrc 让它生效。

⚠️ 注意：我曾经帮一个学员排查问题，发现他配了环境变量但没重启终端。记住，改完环境变量一定要新开一个终端窗口，或者执行 source 命令。

2.2.3 验证安装

打开终端，输入：

flutter doctor

这个命令会检查你的开发环境是否完整。第一次运行会下载一些 Dart SDK 的组件，稍等片刻。你会看到类似这样的输出：

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.x.x, on ...)
[✗] Android toolchain
[✗] Xcode
[✓] Chrome

看到 [✓] 表示通过，[✗] 表示有问题。别慌，接下来咱们一个个解决。

2.3 配置Android Studio

Android Studio 是开发 Android 应用的主力 IDE。说白了，它里面集成了 Android SDK、模拟器、调试工具，一套全齐。

2.3.1 下载安装

去官网下载 Android Studio。安装时记得勾选「Android Virtual Device」（模拟器）。

安装完后，第一次启动会引导你安装 Android SDK。我建议你把 SDK 路径记下来，默认在 C:\Users\你的用户名\AppData\Local\Android\Sdk（Windows）或 ~/Library/Android/sdk（Mac）。

2.3.2 配置Flutter和Dart插件

打开 Android Studio，进入 File → Settings → Plugins（Mac 是 Preferences → Plugins）。

搜索并安装：

  • Flutter 插件（会自动安装 Dart 插件）
  • Dart 插件

安装完后重启 IDE。嗯，这里要注意，插件版本要和 Flutter SDK 版本匹配。我遇到过插件太旧导致代码提示不出来的情况。

2.3.3 配置Android SDK路径

运行 flutter doctor 如果提示 Android SDK 找不到，你需要手动指定路径：

flutter config --android-sdk "你的SDK路径"

比如我 Windows 上就是：

flutter config --android-sdk "C:\Users\deep3321\AppData\Local\Android\Sdk"

2.3.4 创建模拟器

在 Android Studio 中，点击右上角的 AVD Manager 图标，然后「Create Virtual Device」。我建议选 Pixel 4 或 Nexus 6P，系统选 API 33 或 34。

💡 避坑指南：我曾经用了一个 API 30 以下的模拟器，结果发现有些新特性不支持。建议至少用 API 33，兼容性最好。

2.4 配置Xcode（仅限Mac）

如果你用的是 Mac，想开发 iOS 应用，Xcode 是绕不过去的。说实话，Xcode 的安装体验比 Android Studio 简单，但坑也不少。

2.4.1 安装Xcode

从 Mac App Store 搜索「Xcode」下载。文件很大（约 10GB），建议用 Wi-Fi 下载，别用手机热点。

安装完后，打开一次 Xcode，它会自动安装一些命令行工具。你也可以手动安装：

xcode-select --install

2.4.2 接受许可证

第一次在终端使用 Xcode 相关命令时，会提示你接受许可证。直接运行：

sudo xcodebuild -license accept

输入你的 Mac 密码即可。

2.4.3 配置iOS模拟器

Xcode 自带 iOS 模拟器。你可以在 Xcode 的 Xcode → Open Developer Tool → Simulator 中打开它。

我个人习惯用 iPhone 14 Pro 模拟器，屏幕大小适中，调试方便。

⚠️ 注意：如果你用的是 M1/M2 Mac，记得在模拟器中选择「Apple Silicon」架构的模拟器，性能会好很多。Intel 架构的模拟器在 ARM 芯片上跑，说白了就是「翻译运行」，会卡。

2.5 运行 flutter doctor 最终检查

现在，再运行一次 flutter doctor -v。理想情况下，你应该看到：

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.x.x, on ...)
[✓] Android toolchain
[✓] Xcode (Mac only)
[✓] Chrome
[✓] Android Studio
[✓] VS Code (if installed)
[✓] Connected device

如果还有 [✗]，别急。看看它提示什么。比如「Android licenses not accepted」，运行 flutter doctor --android-licenses 然后一路 y 就行。

2.6 创建你的第一个Flutter项目

环境搭好了，咱们来验证一下。打开终端，输入：

flutter create my_first_app
cd my_first_app
flutter run

如果一切顺利，你会看到模拟器上出现了一个默认的 Flutter 应用——一个带加号按钮的计数器。

嗯，看到那个界面的时候，说实话，我当年还挺激动的。虽然只是个 Hello World，但意味着你正式踏入了 Flutter 的世界。

🎯 本章小结：环境搭建是开发的第一步，也是最容易出问题的一步。记住三个关键点：
1. 路径不要有中文
2. 配好环境变量后重启终端
3. 用 flutter doctor 做最终检查
如果遇到问题，别硬扛。去 Flutter 官方文档或 Stack Overflow 搜一下，大概率有人遇到过。

下一章，咱们会深入 Flutter 的项目结构，看看那些自动生成的文件都是干嘛用的。准备好了吗？

← 上一章 📖 返回目录 下一章 →