Flutter 项目快速上手

环境准备略过，安装对应的Flutter 版本和Dart，还有对应的插件。

1. 安装依赖

运行以下命令安装依赖：

flutter pub get

如果项目依赖了 本地插件，还需要执行：

flutter pub upgrade

iOS 项目还需要安装 CocoaPods 依赖：

cd ios && pod install && cd ..

---

2. 运行项目

连接设备

• 真实设备

  （Android / iOS）

  确保已开启 开发者模式，然后执行：

  flutter devices
  

• 模拟器 启动 Android Studio 或 Xcode 模拟器

运行 Flutter 项目

flutter run

如果想指定平台：

flutter run -d chrome  # 运行在 Web
flutter run -d android # 运行在 Android
flutter run -d ios     # 运行在 iOS

---

3. 了解项目结构

打开 lib/ 目录，你需要重点关注：

lib/
│── main.dart          # 入口文件，初始化 App
│── app.dart           # App 配置（主题、路由）
│── pages/             # 业务页面
│   ├── cart/          # 购物车模块
│   ├── order/         # 订单管理
│── models/            # 数据模型
│── repository/        # 数据仓库（数据库缓存、本地存储）
│── api/               # 网络请求封装
│── utils/             # 工具类

如果是 Fish Redux 结构：

│── pages/
│   ├── cart/          # 购物车模块
│   │   ├── action.dart    # Action 事件定义
│   │   ├── effect.dart    # 处理异步操作
│   │   ├── reducer.dart   # 状态更新逻辑
│   │   ├── state.dart     # 组件的 State 结构
│   │   ├── view.dart      # 视图层
│   │   ├── page.dart      # 页面入口

可以从 main.dart 开始，跟踪项目的 路由 和 状态管理 逻辑。

---

4. 运行 Debug 模式

flutter run --debug

然后使用 Flutter DevTools 进行调试：

flutter pub global activate devtools
devtools

如果项目有 API 依赖，确保 .env 配置正确，比如：

API_BASE_URL=https://api.example.com

---

5. 常见问题

1. 运行时报 flutter not found

可能是 Flutter 未正确配置到 PATH，尝试：

export PATH="$PATH:`pwd`/flutter/bin"

2. iOS 运行失败

执行：

cd ios && pod install && cd ..
flutter clean
flutter run

3. 运行 Android 时报 Gradle 相关错误

flutter clean
flutter pub get

如果还不行，尝试升级 Gradle：

cd android
./gradlew wrapper --gradle-version 6.7.1
cd ..