搭建Flutter开发环境

封面图 • 2025-10-24 • Flutter

搭建 Flutter 开发环境是一个相对简单的过程，但需要按照一定的步骤来完成。以下是在 **Windows**、**macOS** 和 **Linux** 上搭建 Flutter 开发环境的详细指南。

---

## ✅ 一、安装 Flutter SDK

### 1. 下载 Flutter SDK
访问 [Flutter 官方网站](https://flutter.dev/docs/get-started/install) 或使用命令行下载：

```bash
# Windows
# 从官网下载：https://docs.flutter.dev/get-started/install/windows

# macOS/Linux
curl -fsSL https://flutter.dev/docs/get-started/install/macos | sh
```

> 推荐手动下载并解压到一个目录（如 `C:\src\flutter` 或 `~/development/flutter`）。

### 2. 配置环境变量

#### Windows：
- 右键“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”
- 在“系统变量”中添加 `FLUTTER_HOME` 指向 Flutter SDK 的路径（例如 `C:\src\flutter`）
- 在 `Path` 中添加 `%FLUTTER_HOME%\bin`

#### macOS/Linux：
在终端中执行：

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

将上面一行添加到你的 shell 配置文件（如 `.bashrc`, `.zshrc`, `.profile` 等），然后运行：

```bash
source ~/.bashrc  # 或 source ~/.zshrc
```

### 3. 验证安装

```bash
flutter --version
```

如果看到版本信息，则说明安装成功。

---

## ✅ 二、安装 Android Studio / VS Code

### 1. Android Studio（推荐）

- 下载地址：[https://developer.android.com/studio](https://developer.android.com/studio)
- 安装后，打开 Android Studio，选择 **"Configure"** -> **"SDK Manager"**
- 安装 **Android SDK Platform Tools** 和 **Android Emulator**

> 如果你只是开发 Flutter 应用，也可以不安装 Android Studio，而是使用其他 IDE。

### 2. VS Code（轻量级推荐）

- 下载地址：[https://code.visualstudio.com/download](https://code.visualstudio.com/download)
- 安装 Flutter 插件：
  - 打开 VS Code
  - 安装插件：**Flutter** 和 **Dart**（由 Dart 团队提供）

---

## ✅ 三、配置 Android 环境（可选）

如果你打算在真机或模拟器上运行 Flutter 应用，需要配置 Android 开发环境。

### 1. 安装 Java JDK

建议安装 **JDK 8 或更高版本**（如 OpenJDK 17）。

### 2. 设置环境变量（Windows）

- `JAVA_HOME` 指向 JDK 安装路径（如 `C:\Program Files\Java\jdk-17.0.1`）
- 在 `Path` 中添加 `%JAVA_HOME%\bin`

### 3. 配置 Android SDK 路径（可选）

```bash
flutter config --android-sdk <path-to-android-sdk>
```

---

## ✅ 四、验证 Flutter 环境

在终端中运行：

```bash
flutter doctor
```

这会检查你的 Flutter 环境是否正确配置。如果出现错误，根据提示进行修复。

---

## ✅ 五、创建第一个 Flutter 项目

```bash
flutter create my_first_app
cd my_first_app
flutter run
```

这会在模拟器或连接的设备上运行你的第一个 Flutter 应用。

---

## 📝 补充说明

| 工具         | 用途                     |
|--------------|--------------------------|
| Flutter SDK  | 提供 Flutter 的核心功能  |
| Android Studio / VS Code | 开发和调试工具     |
| Android Emulator | 测试 Android 应用       |
| Xcode（macOS） | 如果你要开发 iOS 应用    |

---

如果你告诉我你使用的操作系统（Windows/macOS/Linux），我可以给你更详细的步骤。需要我帮你一步步操作吗？ 😊