Flutter 快速入门指南

约 622 字大约 2 分钟

2025-10-16

一份 Flutter 开发环境搭建与项目创建的快速上手指南，帮助你快速启动跨平台开发之旅。

背景与动机

Flutter 是 Google 推出的跨平台 UI 框架，一套代码可同时运行在 Android、iOS、Web、Windows、macOS 和 Linux 上。相比传统原生开发，Flutter 能大幅提升开发效率。

本文适合想要快速搭建 Flutter 开发环境的开发者，涵盖安装、项目创建、项目结构和常用命令。

环境安装

安装 Flutter SDK

首先在 VSCode 中安装 Flutter 插件，然后验证安装是否成功：

flutter --version

配置国内镜像

由于网络原因，国内用户需要配置镜像加速：

echo 'export FLUTTER_STORAGE_BASE_URL="https://mirrors.tuna.tsinghua.edu.cn/flutter"' >> ~/.zshrc
echo 'export PUB_HOSTED_URL="https://mirrors.tuna.tsinghua.edu.cn/dart-pub"' >> ~/.zshrc

配置完成后重启终端或执行 source ~/.zshrc 使其生效。

创建项目

使用以下命令创建新项目：

flutter create my_first_app

项目结构

了解项目结构有助于后续开发：

my_flutter_app/
├── lib/                    # Dart 主代码 - 95% 代码在这里，四端共享
│   ├── main.dart
│   ├── pages/
│   ├── widgets/
│   └── services/
├── android/                # Android 特定配置
│   └── app/src/main/
├── ios/                    # iOS 特定配置
│   └── Runner/
├── windows/                # Windows 特定配置
│   └── runner/
├── macos/                  # macOS 特定配置
│   └── Runner/
└── pubspec.yaml            # 依赖管理

核心代码都在 lib/ 目录下，各平台配置文件修改频率很低。

常用命令

诊断与依赖

# 检查环境配置
flutter doctor

# 清理并重新下载依赖
flutter clean
flutter pub get

# 编译生成代码（如使用 json_serializable 等）
flutter pub run build_runner build

Android 平台

首次开发需要接受 Android 许可协议：

flutter doctor --android-licenses

构建与运行命令：

# 构建 APK（适用于所有安卓设备）
flutter build apk

# 构建指定架构的 APK（体积更小）
flutter build apk --split-per-abi --target-platform android-arm64

# 构建 App Bundle（发布到 Google Play 商店）
flutter build appbundle

# 查看可用模拟器
flutter emulators

# 启动模拟器
flutter emulators --launch Pixel_7

# 运行应用
flutter run -d android

Windows 平台

flutter run -d windows

Web 平台

# 构建 Web 应用
flutter build web

# 在 Chrome 中运行
flutter run -d chrome

# 自动选择设备运行
flutter run

总结

Flutter 一套代码支持六端，开发效率高
国内开发需配置镜像加速
核心代码集中在 lib/ 目录
使用 flutter doctor 快速诊断环境问题
各平台构建命令各有不同，按需使用