创建项目

本篇介绍如何从零创建一个 Flutter 项目、项目结构说明以及常用命令，便于在实战中快速上手。

使用命令行创建项目

基本命令

在终端执行：

flutter create 项目名称

例如创建一个名为 my_app 的应用：

flutter create my_app

项目名称需满足：小写字母、数字、下划线，且不能以数字开头。

常用可选参数

参数	说明
--org <域名反写>	组织标识，如 com.example，会影响 Android 的 applicationId 和 iOS 的 Bundle Identifier
--platforms=	指定要生成的平台，如 ios,android 或 android（不生成 iOS 可加快创建速度）
--project-name	项目名称（含大写、空格时用此指定，目录名可另取）
--template=	模板类型：app（默认）、package（纯 Dart 包）、plugin（插件）

示例：只生成 Android、并指定组织名：

flutter create --org com.mycompany --platforms=android my_app

创建完成后进入项目目录：

cd my_app

项目结构说明

创建后的典型结构如下（只列出常用部分）：

my_app/
├── lib/                 # Dart 代码主目录
│   └── main.dart        # 应用入口
├── android/             # Android 原生工程
├── ios/                 # iOS 原生工程
├── test/                # 测试代码
├── pubspec.yaml         # 依赖与资源声明
├── analysis_options.yaml # 静态分析/规范配置
└── README.md

pubspec.yaml

项目依赖与资源配置文件，新建项目后常改的有：

• name：包名，和项目名一致即可。
• dependencies：生产依赖，如 flutter_sdk: sdk: flutter、第三方包。
• dev_dependencies：开发/测试依赖，如 flutter_test、flutter_lints。
• flutter / assets：图片、字体等资源路径。
• flutter / fonts：自定义字体。

示例片段：

name: my_app
description: A new Flutter project.

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.2

flutter:
  uses-material-design: true
  assets:
    - assets/images/
  fonts:
    - family: MyFont
      fonts:
        - asset: assets/fonts/MyFont.ttf

lib/main.dart

应用入口，默认是一个计数器示例。实战中通常会：

• 在 main() 里 runApp(MyApp())。
• MyApp 使用 MaterialApp 或 CupertinoApp，配置 theme、routes、home 等。
• 后续将页面拆到 lib/screens/、lib/widgets/、lib/utils/ 等目录（见下）。

推荐目录划分（实战）

在 lib/ 下可按功能划分，便于维护：

lib/
├── main.dart              # 入口
├── app.dart               # MaterialApp / 全局配置（可选）
├── constants/             # 常量：颜色、尺寸、文案等
├── theme/                 # 主题定义（见《主题定义》）
├── routes/                # 路由表、命名路由（可选）
├── screens/               # 全屏页面
│   ├── home/
│   └── settings/
├── widgets/               # 通用可复用组件
└── utils/                 # 工具类（如屏幕适配、网络等）

新建文件夹后，在需要处用 import 'package:my_app/xxx/xxx.dart'; 引用（my_app 与 pubspec.yaml 里 name 一致）。

运行与调试

运行

确保已连接设备或已启动模拟器，在项目根目录执行：

flutter run

指定设备（多设备时）：

flutter devices
flutter run -d <device_id>

热重载

运行过程中：

• 终端按 r：热重载（保留状态）。
• 按 R：热重启（重新执行 main()）。
• 按 q：退出。

检查环境

创建或运行前可先执行：

flutter doctor

根据提示安装/配置 Android Studio、Xcode、VS Code 等。

使用 IDE 创建项目（可选）

• VS Code：命令面板 Flutter: New Project，选择应用模板并输入项目名。
• Android Studio：File → New → New Flutter Project，选择 Flutter Application 并设置路径与名称。

创建后的项目结构与命令行一致，可直接用上面的目录与命令进行开发和运行。

小结

• 使用 flutter create 项目名 创建应用，必要时加 --org、--platforms 等参数。
• 关注 lib/、pubspec.yaml 和 main.dart，按 screens/、widgets/、theme/、utils/ 等划分便于实战扩展。
• 使用 flutter run 运行，配合热重载提高开发效率；遇到问题先执行 flutter doctor 检查环境。

下一步可阅读 主题定义 和 屏幕适配，在项目中统一主题与适配方案。