写在前面
很多人学 Flutter 卡在第一步——环境搭建。
不是代码难，是坑太多：SDK 解压到哪里、环境变量怎么配、模拟器跑不起来、flutter doctor 报了一堆错不知道从哪里下手。
这篇文章把整个流程走一遍，每个常见坑都标出来，按步骤做下去，最终目标是在你的电脑上成功运行第一个 Flutter 应用。
一、Flutter SDK 安装与配置
1.1 下载 SDK
打开 Flutter 官网：flutter.dev
点击「Get started」，选择你的操作系统（macOS / Windows / Linux），下载对应的 SDK 压缩包。
⚠️ 注意：不要从 GitHub 直接克隆，官网下载的是稳定版，更适合入门。
文件大小大约在 1-2 GB，国内下载可能较慢，可以用镜像站：
# 国内镜像（中国大陆用户）
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PUB_HOSTED_URL="https://pub.flutter-io.cn"
把这两行加入你的 shell 配置文件（~/.zshrc 或 ~/.bashrc），后续 pub 依赖下载也会走国内镜像，速度快很多。
1.2 解压并放置到合适的位置
macOS / Linux：
# 解压到 home 目录下的 development 文件夹
mkdir -p ~/development
cd ~/development
unzip ~/Downloads/flutter_macos_xxx.zip
Windows：
建议解压到 C:\development\flutter，不要放在以下路径：
- 桌面（路径含空格容易出问题）
C:\Program Files（需要管理员权限，后续会有麻烦）- 任何路径中包含中文字符的文件夹
⚠️ 这是 Windows 上最常见的坑：路径含有空格或中文，后续命令会报莫名其妙的错误。
1.3 配置环境变量
这一步是重点，也是出错最多的地方。
macOS（以 zsh 为例）：
# 打开配置文件
nano ~/.zshrc
# 在文件末尾添加
export PATH="$PATH:$HOME/development/flutter/bin"
# 保存后执行让配置生效
source ~/.zshrc
Windows：
- 搜索「编辑系统环境变量」
- 点击「环境变量」
- 在「用户变量」的 Path 里，点「新建」
