跳到主要内容

Flutter 环境配置

本章将指导你完成 Flutter 开发环境的安装和配置。

系统要求​

Windows​

  • Windows 10 或更高版本（64 位）
  • 至少 1.64 GB 的磁盘空间（不包含 IDE/工具）
  • Git for Windows

macOS​

  • macOS 10.15 (Catalina) 或更高版本
  • 至少 2.8 GB 的磁盘空间
  • Xcode（用于 iOS 开发）

Linux​

  • 64 位 Linux
  • 至少 600 MB 的磁盘空间
  • 相关工具：bash、curl、file、git、mkdir、rm、unzip、which、xz-utils

安装 Flutter SDK​

方法一：使用官方安装包（推荐）​

Windows​

  1. 下载 Flutter SDK 访问 Flutter 官网 下载最新稳定版

  2. 解压到目录

    # 建议解压到 C:\src\flutter（避免路径中包含空格和特殊字符）

  3. 添加到 PATH

    # 在系统环境变量中添加
    C:\src\flutter\bin

macOS​

# 使用 Homebrew 安装
brew install --cask flutter

# 或者下载压缩包并解压
cd ~/development
unzip ~/Downloads/flutter_macos_*.zip

添加到 PATH：

# 编辑 ~/.zshrc 或 ~/.bash_profile
export PATH="$PATH:$HOME/development/flutter/bin"

Linux​

# 下载 Flutter SDK
cd ~/development
wget https://storage.googleapis.com/flutter_infra_release/releases/stable/linux/flutter_linux_*.tar.xz
tar xf flutter_linux_*.tar.xz

# 添加到 PATH
export PATH="$PATH:$HOME/development/flutter/bin"

方法二：使用 Git​

git clone https://github.com/flutter/flutter.git -b stable
export PATH="$PATH:`pwd`/flutter/bin"

安装开发工具​

Android Studio（推荐用于 Android 开发）​

  1. 下载并安装 Android Studio
  2. 启动 Android Studio，完成初始设置向导
  3. 安装 Flutter 和 Dart 插件：
    • 打开 Settings → Plugins
    • 搜索 "Flutter" 并安装
    • 重启 Android Studio

VS Code（轻量级选择）​

  1. 下载并安装 VS Code
  2. 安装 Flutter 扩展：
    • 打开扩展面板（Ctrl+Shift+X）
    • 搜索 "Flutter" 并安装
    • Dart 插件会随 Flutter 插件一起安装

Xcode（仅 macOS，用于 iOS 开发）​

# 安装 Xcode
xcode-select --install

# 同意 Xcode 许可协议
sudo xcodebuild -license

# 配置 iOS 模拟器
open -a Simulator

验证安装​

运行 flutter doctor 检查环境配置：

flutter doctor

输出示例：

Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.x.x, on macOS 13.0)
[✓] Android toolchain - develop for Android devices
[✓] Xcode - develop for iOS and macOS
[✓] Chrome - develop for the web
[✓] Android Studio
[✓] VS Code
[✓] Connected device
[✓] Network resources

• No issues found!

根据提示修复未通过的检查项。

配置 Android 模拟器​

创建虚拟设备​

  1. 打开 Android Studio
  2. 点击 Tools → Device Manager
  3. 点击 Create Device
  4. 选择设备型号（如 Pixel 6）
  5. 选择系统镜像（推荐最新稳定版）
  6. 完成创建

使用真机调试​

  1. 在手机上启用开发者选项
  2. 启用 USB 调试
  3. 连接手机到电脑
  4. 运行 flutter devices 确认设备已识别

配置 iOS 模拟器（仅 macOS）​

# 打开 iOS 模拟器
open -a Simulator

# 查看可用的模拟器
xcrun simctl list devices

创建第一个项目​

使用命令行​

# 创建新项目
flutter create my_first_app

# 进入项目目录
cd my_first_app

# 运行项目
flutter run

使用 IDE​

  1. Android Studio: File → New → New Flutter Project
  2. VS Code: View → Command Palette → Flutter: New Project

项目结构​

my_first_app/
├── android/          # Android 平台代码
├── ios/              # iOS 平台代码
├── lib/              # Dart 源代码
│   └── main.dart     # 应用入口
├── test/             # 测试代码
├── web/              # Web 平台代码（如果启用）
├── pubspec.yaml      # 项目配置和依赖
└── README.md         # 项目说明

pubspec.yaml 解析​

name: my_first_app
description: 我的第一个 Flutter 应用

# Dart SDK 版本要求
environment:
  sdk: '>=3.0.0 <4.0.0'

# 依赖项
dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.2

# 开发依赖
dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^2.0.0

# Flutter 特定配置
flutter:
  uses-material-design: true

常用命令​

# 查看 Flutter 版本
flutter --version

# 升级 Flutter
flutter upgrade

# 查看可用设备
flutter devices

# 运行应用
flutter run                    # 运行在默认设备
flutter run -d chrome          # 运行在 Chrome
flutter run -d emulator-5554   # 运行在指定模拟器

# 构建应用
flutter build apk              # 构建 Android APK
flutter build ios              # 构建 iOS 应用
flutter build web              # 构建 Web 应用

# 清理构建缓存
flutter clean

# 获取依赖
flutter pub get

常见问题​

1. Flutter doctor 显示 Android SDK 未配置​

# 设置 Android SDK 路径
flutter config --android-sdk /path/to/android/sdk

2. iOS 构建失败​

cd ios
pod repo update
pod install

3. 依赖下载慢​

使用国内镜像：

# 设置环境变量
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

小结​

本章我们学习了：

  1. Flutter 的系统要求
  2. Flutter SDK 的安装方法
  3. 开发工具的配置（Android Studio、VS Code）
  4. 模拟器和真机调试的配置
  5. 创建和运行第一个项目
  6. 项目结构和常用命令

下一步​

环境配置完成后，下一章我们将学习 Dart 语言基础，掌握 Flutter 开发所需的语言知识。