从零开始：Flutter 开发环境搭建全指南

Flutter 是 Google 推出的跨平台 UI 开发框架，可快速构建高性能、跨 iOS 和 Android 的原生应用。本文将详细讲解不同操作系统（Windows/macOS/Linux）下 Flutter 环境的完整搭建流程，涵盖基础配置、IDE 选型、环境验证等核心步骤，帮助新手快速上手。

一、搭建前的准备

1. 硬件要求

系统	最低配置要求
Windows	Windows 10/11 64 位、4GB 以上内存、开启硬件虚拟化（VT-x/AMD-V）、磁盘空间 ≥ 10GB
macOS	macOS 12+、Intel/Apple Silicon 芯片、4GB 以上内存、磁盘空间 ≥ 10GB
Linux	Ubuntu 20.04+/Debian 11+ 64 位、4GB 以上内存、磁盘空间 ≥ 10GB

2. 软件依赖

• Git ：用于克隆 Flutter 源码和版本控制（下载地址）
• Java Development Kit (JDK) ：建议 JDK 17（Android 开发必需，下载地址）
• Android Studio（可选但推荐）：集成 Android SDK、模拟器，支持 Flutter 开发
• Xcode（仅 macOS）：iOS/iPadOS 开发必需，需 App Store 下载或开发者官网获取

二、分系统搭建步骤

（一）Windows 系统

步骤 1：下载 Flutter SDK

1. 访问 Flutter 官方下载页：https://flutter.dev/docs/get-started/install/windows
2. 下载最新稳定版 Flutter SDK 压缩包（flutter_windows_xxx-stable.zip）。
3. 解压到自定义目录（建议非中文、无空格路径，如 D:\flutter）。

步骤 2：配置系统环境变量

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」。
2. 用户变量 中，找到「Path」→「编辑」→「新建」，添加 Flutter 工具路径：D:\flutter\bin（对应解压路径）。
3. 系统变量 中，新建变量：
   • 变量名：FLUTTER_STORAGE_BASE_URL，变量值：https://storage.flutter-io.cn（国内镜像，加速下载）
   • 变量名：PUB_HOSTED_URL，变量值：https://pub.flutter-io.cn（国内镜像）
4. 保存后，重启命令行工具（CMD/PowerShell）使配置生效。

步骤 3：安装 Android Studio

1. 下载 Android Studio：https://developer.android.com/studio
2. 安装时勾选「Android SDK」「Android Virtual Device」，默认路径即可（避免中文）。
3. 启动 Android Studio，完成初始化（需下载 SDK 组件，耐心等待）。
4. 安装 Flutter 插件：
   • 打开「File」→「Settings」→「Plugins」。
   • 搜索「Flutter」，点击「Install」，安装完成后重启 IDE。
   • 插件会自动提示安装 Dart 插件（Flutter 依赖 Dart，必须安装）。

步骤 4：配置 Android 环境

1. 打开 Android Studio →「Tools」→「SDK Manager」。
2. 在「SDK Platforms」中，勾选至少一个 Android 版本（建议最新稳定版，如 Android 14）。
3. 在「SDK Tools」中，勾选「Android SDK Build-Tools」「Android Emulator」「Android SDK Platform-Tools」，点击「Apply」下载。
4. 配置 Android SDK 环境变量：
   • 系统变量中新建 ANDROID_HOME，值为 SDK 路径（如 C:\Users\用户名\AppData\Local\Android\Sdk）。
   • Path 中添加 %ANDROID_HOME%\platform-tools 和 %ANDROID_HOME%\tools\bin。

（二）macOS 系统

macOS 需同时支持 iOS 和 Android 开发，步骤如下：

步骤 1：安装依赖工具

1. 安装 Homebrew（包管理器）：

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

2. 安装 Git 和 Ruby（CocoaPods 依赖）：

   brew install git ruby

步骤 2：下载并配置 Flutter SDK

1. 下载 Flutter SDK：https://flutter.dev/docs/get-started/install/macos

2. 解压到自定义目录（如 ~/development/flutter）。

3. 配置环境变量（zsh 终端，默认 macOS 10.15+ 为 zsh）：

   # 编辑 ~/.zshrc 文件
   open ~/.zshrc
   # 添加以下内容
   export PATH="$PATH:~/development/flutter/bin"
   export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
   export PUB_HOSTED_URL=https://pub.flutter-io.cn
   # 生效配置
   source ~/.zshrc

   （若为 bash 终端，编辑 ~/.bash_profile，步骤同上）

步骤 3：安装 Xcode（iOS 开发必需）

1. 从 App Store 下载 Xcode（需登录 Apple ID）。

2. 打开 Xcode，同意许可协议，安装 Command Line Tools：

   xcode-select --install

3. 配置 Xcode 命令行工具路径：

   sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

4. 安装 CocoaPods（iOS 依赖管理工具）：

   sudo gem install cocoapods

步骤 4：安装 Android Studio（Android 开发）

1. 下载并安装 Android Studio：https://developer.android.com/studio
2. 安装 Flutter 和 Dart 插件（同 Windows 步骤）。
3. 配置 Android SDK（同 Windows 步骤），macOS 下 SDK 路径默认：~/Library/Android/sdk。

（三）Linux 系统（以 Ubuntu 为例）

步骤 1：安装依赖

sudo apt update
sudo apt install -y git curl unzip openjdk-17-jdk

步骤 2：下载并配置 Flutter SDK

1. 下载 Flutter SDK：https://flutter.dev/docs/get-started/install/linux

2. 解压到 ~/flutter 目录：

   unzip flutter_linux_xxx-stable.zip -d ~/

3. 配置环境变量：

   # 编辑 ~/.bashrc
   nano ~/.bashrc
   # 添加内容
   export PATH="$PATH:~/flutter/bin"
   export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
   export PUB_HOSTED_URL=https://pub.flutter-io.cn
   # 生效
   source ~/.bashrc

步骤 3：安装 Android Studio

1. 下载 Android Studio 压缩包，解压并安装：

   sudo dpkg -i android-studio-xxx.deb

2. 后续插件安装、SDK 配置同 Windows 步骤。

三、环境验证与问题修复

1. 基础验证

打开终端 / CMD，执行以下命令，检查 Flutter 环境：

flutter doctor

该命令会检测所有依赖项，并输出问题提示（红色 × 为未配置项，黄色！为警告）。

2. 常见问题修复

• 问题 1 ：Android license status unknown（Android 许可未同意）解决：执行 flutter doctor --android-licenses，一路输入 y 同意所有许可。
• 问题 2：iOS 模拟器无法启动（macOS）解决：打开 Xcode →「Preferences」→「Components」，下载对应 iOS 版本的模拟器。
• 问题 3：Flutter 命令找不到解决：重新检查环境变量配置，确保 Flutter 的 bin 目录已添加到 Path。
• 问题 4：国内下载依赖慢 / 失败解决：确认已配置 Flutter 国内镜像（FLUTTER_STORAGE_BASE_URL 和 PUB_HOSTED_URL），或使用代理。

3. 最终验证

创建第一个 Flutter 项目，验证环境是否可用：

# 创建项目
flutter create my_first_app
# 进入项目目录
cd my_first_app
# 运行项目（需启动模拟器或连接真机）
flutter run

若模拟器 / 真机中成功显示 Flutter 示例页面，说明环境搭建完成。

四、可选配置：VS Code 开发

若不想使用 Android Studio，可选择轻量的 VS Code：

1. 下载 VS Code：https://code.visualstudio.com/
2. 安装 Flutter 插件：打开 VS Code → 扩展商店 → 搜索「Flutter」→ 安装（自动包含 Dart 插件）。
3. 配置 Flutter 路径：VS Code → 设置 → 搜索「Flutter SDK Path」→ 填写 Flutter 解压路径（如 D:\flutter）。
4. 验证：打开终端 → 执行 flutter doctor，确认无报错。

五、总结

Flutter 环境搭建核心是「SDK 配置 + 平台依赖（Android/iOS） + IDE 插件」，不同系统的差异主要在环境变量和平台工具（如 Xcode 仅 macOS 需安装）。搭建完成后，通过 flutter doctor 排查问题，通过创建示例项目验证可用性，即可开始 Flutter 开发之旅。

如果遇到特定问题，可参考 Flutter 官方文档（https://flutter.dev/docs/get-started/install）或社区问答（Stack Overflow/Flutter 中文网）。