第2章：Flutter开发环境搭建

说实话，搭建开发环境这件事，看着简单，但坑是真不少。我见过太多新手卡在这一步，折腾一整天连个Hello World都跑不出来。今天我就把Windows和Mac两套系统的搭建流程，以及我踩过的坑，一次性给你讲清楚。

2.1 系统要求：你的电脑够格吗？

先别急着下载，看看你的电脑能不能跑得动。我个人习惯是，不管什么项目，先把硬件底线摸清楚。

项目 Windows Mac
操作系统 Windows 10/11（64位） macOS 10.15+（Catalina以上）
磁盘空间 至少8GB（含Android Studio） 至少8GB（含Xcode）
内存 8GB起步，16GB更稳 8GB起步，16GB更稳
处理器 Intel/AMD x86_64 Intel或Apple Silicon（M1/M2）
⚠️ 注意：如果你用的是Mac M1/M2芯片，记得下载ARM64版本的Flutter SDK。我刚开始没注意，下了个Intel版，跑起来卡得不行。

2.2 Flutter SDK安装与配置

这是最核心的一步。说白了，Flutter SDK就是你的工具箱，没有它啥也干不了。

Windows系统安装步骤

  1. 下载SDK：去Flutter官网下载最新稳定版。我个人建议别追新，稳定版最靠谱。
  2. 解压：解压到 C:\src\flutter。注意路径不要有中文和空格，否则后面有你哭的。
  3. 配置环境变量：把 C:\src\flutter\bin 加到系统Path里。
  4. 验证安装：打开命令行，输入 flutter doctor。

我踩过的坑：曾经有一次，我把Flutter解压到了带空格的路径下，结果编译时各种报错。排查了整整两个小时，最后发现是路径问题。从那以后，我所有开发工具都放在纯英文路径下。

Mac系统安装步骤

  1. 下载SDK：同样去官网下载，记得选macOS版本。
  2. 解压：解压到 ~/development/flutter。
  3. 配置环境变量：编辑 ~/.zshrc（如果你用bash就是 ~/.bash_profile），添加：
export PATH="$PATH:$HOME/development/flutter/bin"
  1. 生效配置：运行 source ~/.zshrc。
  2. 验证：运行 flutter doctor。

💡 小技巧：Mac用户建议用Homebrew安装，命令就一行：brew install --cask flutter。省事多了。

2.3 Android Studio与VS Code插件安装

编辑器选哪个？我两个都用。Android Studio适合大项目，VS Code轻量快捷。你想想看，写个小demo还开个Android Studio，是不是有点杀鸡用牛刀？

Android Studio配置

  1. 安装Android Studio（官网下载，一路Next就行）。
  2. 启动后，进入 Plugins 市场，搜索并安装 Flutter 插件。
  3. 安装Flutter插件时，它会自动提示安装Dart插件，点同意就行。
  4. 配置Android SDK：在 SDK Manager 里，至少安装Android 11（API 30）以上的版本。
⚠️ 注意：Android Studio安装Flutter插件后，记得重启。我见过有人装完不重启，结果插件死活不生效。

VS Code配置

  1. 安装VS Code（这个不用我教了吧）。
  2. 打开扩展面板（Ctrl+Shift+X），搜索 Flutter。
  3. 安装 Flutter 和 Dart 两个扩展。
  4. 按 Ctrl+Shift+P，输入 Flutter: New Project，测试一下能不能创建项目。

💡 我的习惯：VS Code里我还会装一个 Awesome Flutter Snippets 插件，写代码时打几个字母就能生成模板，效率翻倍。

2.4 模拟器与真机调试配置

环境搭好了，总得跑起来看看效果吧？这里分模拟器和真机两种情况。

Android模拟器配置

  1. 在Android Studio里打开 AVD Manager（虚拟设备管理器）。
  2. 点击 Create Virtual Device，选一个设备，比如Pixel 4。
  3. 选择系统镜像，建议选 x86_64 的，跑起来快。
  4. 启动模拟器，然后在终端运行 flutter run。

我曾经... 用了一个ARM镜像的模拟器，启动花了5分钟，跑起来卡成PPT。后来换成x86_64镜像，秒开。所以镜像选对了，体验天差地别。

iOS模拟器配置（仅Mac）

  1. 确保安装了Xcode（从App Store下载，十几G，提前准备好空间）。
  2. 打开Xcode，进入 Preferences → Locations，确保Command Line Tools已选好。
  3. 在终端运行 open -a Simulator 启动模拟器。
  4. 运行 flutter run，Flutter会自动识别iOS模拟器。

真机调试配置

真机调试其实比模拟器更靠谱，因为能真实反映性能。但配置起来稍微麻烦点。

Android真机：

  1. 打开手机的 开发者选项：设置 → 关于手机 → 连续点击版本号7次。
  2. 进入开发者选项，开启 USB调试。
  3. 用数据线连接电脑，手机上会弹出授权提示，点允许。
  4. 终端运行 flutter devices，如果能看到设备，就说明连上了。

iOS真机（仅Mac）：

  1. 需要Apple开发者账号（免费版也行）。
  2. 在Xcode里打开项目，配置好Team和Bundle Identifier。
  3. 用数据线连接iPhone，在设备上信任这台电脑。
  4. 运行 flutter run，选择你的iPhone。
⚠️ 注意：iOS真机调试第一次会比较慢，因为要处理签名和证书。别急，等它跑完就好。

2.5 常见环境问题排查

环境搭建过程中，你大概率会遇到下面这些问题。我按出现频率排个序，你对照着查就行。

问题 原因 解决方案
flutter doctor 报错 环境变量没配好 检查Path里有没有flutter/bin路径
Android license not accepted 没同意Android SDK协议 运行 flutter doctor --android-licenses，一路y
模拟器启动黑屏 显卡驱动或镜像问题 更新显卡驱动，或换一个系统镜像
真机连接不上 USB调试没开或驱动问题 检查开发者选项，Windows需安装手机驱动
Mac上Xcode版本不匹配 Xcode太旧或太新 去App Store更新Xcode到最新稳定版

我的经验：遇到问题先别慌，运行 flutter doctor -v 看详细日志。90%的问题，日志里都会告诉你具体怎么修。剩下的10%，嗯，去Stack Overflow搜一下，基本都有答案。

好了，环境搭建就讲到这里。你跟着步骤走一遍，应该半小时内就能跑起来。下一章我们开始写第一个Flutter应用，到时候你就知道，前面这些折腾都是值得的。

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