【Flutter Todo 实战】第二章：环境搭建

2.1 安装 Flutter SDK

什么是 Flutter SDK？

Flutter SDK（Software Development Kit，软件开发工具包）是开发 Flutter 应用所需的一整套工具，包括：

Flutter 框架代码
Dart 编译器
开发工具（如热重载）
示例代码和文档

系统要求

Windows:

操作系统：Windows 10 或更高版本（64位）
磁盘空间：至少 2.5 GB（不包括 IDE）
Git for Windows

macOS:

操作系统：macOS 10.14 或更高版本
磁盘空间：至少 2.8 GB（不包括 IDE）

Linux:

操作系统：64位 Linux 发行版
磁盘空间：至少 600 MB（不包括 IDE）

安装步骤

步骤 1：下载 Flutter SDK

打开浏览器，访问 Flutter 官网下载页面：

https://docs.flutter.dev/get-started/install

根据你的操作系统选择对应的安装包下载。

步骤 2：解压并配置环境变量

Windows:

解压下载的 zip 文件到 C:\flutter
将 C:\flutter\bin 添加到系统 PATH 环境变量
打开命令提示符，运行：

1flutter doctor

macOS/Linux:

解压下载的文件到合适的位置（推荐 ~/development/flutter）
打开终端，编辑配置文件：

1# 如果使用 bash
2nano ~/.bashrc
3
4# 如果使用 zsh（macOS 默认）
5nano ~/.zshrc

添加以下行：

1export PATH="$PATH:~/development/flutter/bin"

保存并退出，然后运行：

1source ~/.bashrc  # 或 source ~/.zshrc
2flutter doctor

步骤 3：运行 Flutter Doctor

flutter doctor 命令会检查你的环境是否配置正确。你会看到类似这样的输出：

[✓] Flutter (Channel stable, 3.16.0, ...)
[✓] Android toolchain - develop for Android devices
[!] Xcode - develop for iOS and macOS
    ✗ Xcode not installed
[✓] Chrome - develop for the web
[✓] Android Studio
[!] Connected device
    ! No devices available

[✓] 表示该项已正确配置
[!] 表示可选配置，可以稍后设置
[✗] 表示需要修复的问题

安装 IDE

推荐使用以下 IDE 之一：

Android Studio（推荐）

下载并安装 Android Studio：https://developer.android.com/studio
打开 Android Studio，安装 Flutter 插件：
- 打开 File > Settings > Plugins
- 搜索 "Flutter" 并安装
- 重启 Android Studio

Visual Studio Code

下载并安装 VS Code：https://code.visualstudio.com/
安装 Flutter 扩展：
- 打开扩展面板（Ctrl+Shift+X）
- 搜索 "Flutter" 并安装

配置模拟器

Android 模拟器

打开 Android Studio
打开 Tools > Device Manager
点击 Create Device
选择设备（推荐 Pixel 系列）
选择系统镜像（推荐最新稳定版）
完成创建

iOS 模拟器（仅 macOS）

打开 Xcode
打开 Xcode > Preferences > Components
下载 iOS 模拟器
或使用命令行：

1open -a Simulator

2.2 创建第一个 Flutter 项目

使用命令行创建

打开终端，运行：

1# 创建新项目
2flutter create my_first_app
3
4# 进入项目目录
5cd my_first_app
6
7# 运行应用
8flutter run

使用 Android Studio 创建

打开 Android Studio
选择 File > New > New Flutter Project
选择 Flutter Application
配置项目名称和位置
点击 Finish

使用 VS Code 创建

打开 VS Code
按 Ctrl+Shift+P 打开命令面板
输入并选择 Flutter: New Project
选择 Application
选择项目位置并命名

2.3 运行你的第一个应用

连接设备

真机调试：

Android：开启开发者选项和 USB 调试
iOS：使用数据线连接 Mac，信任设备

模拟器：

启动你之前创建的模拟器。

运行应用

在项目目录下运行：

1flutter run

或者使用 IDE 的运行按钮。

看到什么？

你应该会看到一个计数器应用，点击按钮数字会增加：

┌─────────────────┐
│                 │
│    You have     │
│   pushed the    │
│   button this   │
│  many times:    │
│                 │
│        0        │
│                 │
│    [+]          │
│                 │
└─────────────────┘

恭喜你！你的 Flutter 环境配置成功了！

2.4 常用 Flutter 命令

命令	作用
`flutter doctor`	检查环境配置
`flutter create`	创建新项目
`flutter run`	运行应用
`flutter build apk`	构建 Android APK
`flutter build ios`	构建 iOS 应用
`flutter pub get`	获取依赖包
`flutter clean`	清理构建缓存
`flutter devices`	列出可用设备

2.5 热重载（Hot Reload）

Flutter 最强大的功能之一就是热重载。当你修改代码后，按 r 键（在终端中）或点击 IDE 的热重载按钮，应用会立即更新，状态保持不变！

试试看：

打开 lib/main.dart
找到 'You have pushed the button this many times:'
改成 '按钮点击次数：'
保存文件（Ctrl+S）
按 r 键

应用立即更新了，数字没有归零！这就是热重载的魔力。

2.6 常见问题

问题 1：找不到 flutter 命令

解决： 检查 PATH 环境变量是否正确配置。

问题 2：Android SDK 未找到

解决：

打开 Android Studio
打开 SDK Manager（Tools > SDK Manager）
安装 Android SDK
设置 ANDROID_SDK_ROOT 环境变量

问题 3：模拟器无法启动