Flutter项目目录结构详解：了解lib、ohos、android等核心目录

红目香薰

49人浏览 · 2026-07-19 08:54:04

红目香薰 · 2026-07-19 08:54:04 发布

在这里插入图片描述

作者：付文龙（红目香薰）
仓库地址：https://gitcode.com/feng8403000/FlutterfromBeginnertoAdvancedForHarmonyOS.git
联系邮箱：372699828@qq.com

一、引言

在开始深入学习Flutter开发之前，我们首先需要了解一个完整的Flutter项目的目录结构。一个规范的项目结构不仅能提高代码的可维护性，还能让团队协作更加高效。特别是对于鸿蒙平台的开发者来说，了解Flutter项目的目录结构尤为重要，因为它涉及到跨平台开发的特殊配置。

1.1 为什么目录结构如此重要？

一个好的目录结构具有以下优点：

可读性强：新成员能够快速理解项目组织方式
可维护性高：代码定位方便，修改和扩展更加容易
协作效率高：团队成员可以按照统一的规范进行开发
易于扩展：新功能可以按照现有模式添加，不会破坏整体结构

1.2 本章学习目标

通过本章的学习，你将掌握：

二、Flutter项目基础目录结构

当你使用flutter create命令创建一个新的Flutter项目时，会生成一个标准的目录结构。让我们一起来了解这个结构。

2.1 项目根目录

一个典型的Flutter项目根目录包含以下文件和文件夹：

my_flutter_app/
├── lib/                  # Dart源代码
├── ohos/                 # 鸿蒙平台代码
├── android/              # Android平台代码
├── ios/                  # iOS平台代码
├── web/                  # Web平台代码
├── test/                 # 测试代码
├── pubspec.yaml          # 依赖配置
├── pubspec.lock          # 依赖锁定文件
├── README.md             # 项目说明
├── .gitignore            # Git忽略配置
└── analysis_options.yaml # 代码分析配置

2.2 核心目录详解

2.2.1 lib目录

lib目录是Flutter项目的核心，包含所有Dart源代码。这是我们日常开发中最常接触的目录。

lib/
├── main.dart         # 应用入口，包含main函数
├── app.dart          # 应用根组件
├── pages/            # 页面组件
├── widgets/          # 自定义组件
├── models/           # 数据模型
├── services/         # 服务层（网络请求、数据处理）
├── utils/            # 工具函数
└── constants/        # 常量定义

main.dart：这是Flutter应用的入口文件，包含main函数，是应用启动的起点。

import 'package:flutter/material.dart';
import 'app.dart';

void main() {
  runApp(const MyApp());
}

pages目录：存放所有页面级组件，每个页面通常是一个独立的Widget。

widgets目录：存放可复用的自定义组件，如按钮、卡片、列表项等。

models目录：存放数据模型类，用于封装业务数据。

services目录：存放业务逻辑层代码，如网络请求、数据库操作等。

utils目录：存放工具函数，如日期格式化、字符串处理等。

constants目录：存放常量定义，如颜色、字体大小、API地址等。

2.2.2 ohos目录

ohos目录是鸿蒙平台特有的目录，包含鸿蒙平台的原生代码和配置文件。

ohos/
├── AppScope/                     # 应用级别配置
│   ├── app.json5                 # 应用配置
│   └── resources/                # 应用级资源
└── entry/                        # 入口模块
    ├── src/
    │   └── main/
    │       ├── ets/              # ArkTS源代码
    │       ├── resources/        # 模块资源
    │       └── module.json5      # 模块配置
    ├── oh-package.json5          # 依赖配置
    └── build-profile.json5       # 构建配置

AppScope目录：包含应用级别的配置，如应用名称、版本号、权限声明等。

entry目录：包含模块级别的代码和配置，是应用的入口模块。

2.2.3 android目录

android目录包含Android平台的原生代码和配置。

android/
├── app/
│   ├── src/
│   │   └── main/
│   │       ├── java/            # Java/Kotlin源代码
│   │       ├── res/             # 资源文件
│   │       └── AndroidManifest.xml
│   └── build.gradle
├── gradle/
├── build.gradle
└── settings.gradle

app目录：包含Android应用的核心代码和配置。

AndroidManifest.xml：Android应用的清单文件，声明权限、Activity等。

2.2.4 ios目录

ios目录包含iOS平台的原生代码和配置。

ios/
├── Runner/
│   ├── AppDelegate.swift        # 应用代理
│   ├── Runner-Bridging-Header.h # Swift与Objective-C桥接
│   ├── Assets.xcassets/         # 资源文件
│   └── Info.plist               # 应用配置
├── Runner.xcodeproj/            # Xcode项目文件
└── Podfile                      # CocoaPods配置

Runner目录：包含iOS应用的核心代码。

Info.plist：iOS应用的配置文件，声明权限、应用名称等。

2.2.5 web目录

web目录包含Web平台的相关文件。

web/
├── index.html                   # HTML入口
├── manifest.json                # Web应用配置
└── icons/                       # 图标资源

index.html：Web应用的入口HTML文件。

三、pubspec.yaml配置文件

pubspec.yaml是Flutter项目的核心配置文件，用于管理项目的依赖、资源和元数据。

3.1 基本结构

name: harmonyos_study
description: Flutter学习示例应用，支持鸿蒙平台

version: 1.0.0+1

environment:
  sdk: '>=3.0.0 <4.0.0'

dependencies:
  flutter:
    sdk: flutter
  
  cupertino_icons: ^1.0.2
  http: ^1.0.0

dev_dependencies:
  flutter_test:
    sdk: flutter
  
  flutter_lints: ^2.0.0

flutter:
  uses-material-design: true
  
  assets:
    - assets/images/
    - assets/icons/
  
  fonts:
    - family: Roboto
      fonts:
        - asset: fonts/Roboto-Regular.ttf

3.2 关键配置项说明

3.2.1 name和description

name：项目名称，也是包名
description：项目描述，用于pub.dev上的展示

3.2.2 version

项目版本号，格式为主版本号.次版本号.修订号+构建号。

3.2.3 environment

指定项目所需的Dart SDK版本范围。

3.2.4 dependencies

声明项目依赖的第三方包。

flutter：Flutter框架本身
cupertino_icons：iOS风格的图标库
http：HTTP请求库

3.2.5 dev_dependencies

声明开发环境依赖的包，如测试框架、代码检查工具等。

3.2.6 flutter

Flutter特定的配置项。

uses-material-design：是否使用Material Design组件
assets：声明资源文件路径
fonts：声明自定义字体

四、实战：组织一个Flutter学习助手项目

现在，让我们将理论应用到实践中，组织一个Flutter学习助手项目的目录结构。

4.1 项目需求分析

我们需要创建一个Flutter学习助手应用，包含以下功能：

知识点列表展示
示例代码查看
章节导航
博客文章阅读

4.2 目录结构设计

基于需求分析，我们设计如下目录结构：

Flutter学习助手/
├── lib/
│   ├── main.dart                 # 应用入口
│   ├── app.dart                  # 应用根组件
│   ├── examples/                 # 示例代码
│   │   ├── chapter_01/           # 第一章示例
│   │   │   ├── section_1_1/      # 1.1节示例
│   │   │   │   ├── 001_dart_overview.dart
│   │   │   │   ├── 002_variable_types.dart
│   │   │   │   └── ...
│   │   │   └── section_1_2/      # 1.2节示例
│   │   │       ├── 011_project_structure.dart
│   │   │       └── ...
│   │   └── chapter_02/           # 第二章示例
│   ├── pages/                    # UI页面
│   │   ├── chapter_01/
│   │   │   ├── section_1_1/
│   │   │   │   ├── 001_dart_overview_page.dart
│   │   │   │   └── ...
│   │   │   └── section_1_2/
│   │   │       ├── 011_project_structure_page.dart
│   │   │       └── ...
│   │   └── home_page.dart        # 首页
│   ├── widgets/                  # 自定义组件
│   │   ├── example_card.dart     # 示例卡片组件
│   │   └── section_header.dart   # 章节标题组件
│   ├── constants/                # 常量定义
│   │   ├── app_colors.dart       # 颜色常量
│   │   ├── app_fonts.dart        # 字体常量
│   │   ├── app_spacing.dart      # 间距常量
│   │   └── app_strings.dart      # 字符串常量
│   └── routes/                   # 路由管理
│       └── app_routes.dart       # 路由配置
├── blog/                         # 博客文章
│   └── chapter_01/
│       ├── section_1_1/          # 1.1节博客
│       └── section_1_2/          # 1.2节博客
├── assets/                       # 资源文件
│   ├── images/                   # 图片资源
│   └── icons/                    # 图标资源
└── ohos/                         # 鸿蒙平台代码
    └── entry/                    # 入口模块

4.3 目录结构设计思路

4.3.1 按功能模块划分

将代码按照功能模块进行划分，如examples、pages、widgets等，每个模块负责特定的功能。

4.3.2 按章节组织示例代码

示例代码按照章节和小节进行组织，便于查找和管理。

4.3.3 分离关注点

将UI组件、业务逻辑、数据模型等分离到不同的目录中，遵循单一职责原则。

五、鸿蒙平台特殊配置

5.1 鸿蒙平台目录结构

鸿蒙平台的目录结构与Android有所不同，需要特别注意。

ohos/
├── AppScope/
│   ├── app.json5
│   └── resources/
│       ├── base/
│       │   ├── element/          # 元素资源（颜色、尺寸等）
│       │   ├── media/            # 媒体资源（图片、音频等）
│       │   └── profile/          # 配置文件
│       └── rawfile/              # 原始文件
└── entry/
    ├── src/
    │   └── main/
    │       ├── ets/
    │       │   ├── entryability/ # 入口Ability
    │       │   └── pages/        # 页面
    │       ├── resources/        # 模块资源
    │       └── module.json5
    ├── oh-package.json5
    └── build-profile.json5

5.2 鸿蒙资源管理

鸿蒙平台使用resources目录来管理应用资源，包括：

element：颜色、尺寸、字符串等元素资源
media：图片、音频、视频等媒体资源
profile：配置文件
rawfile：原始文件，如JSON、XML等

5.3 模块配置文件

module.json5：定义模块的基本信息、权限声明、Ability配置等。

{
  "module": {
    "name": "entry",
    "type": "entry",
    "description": "$string:module_desc",
    "mainElement": "EntryAbility",
    "deviceTypes": ["phone", "tablet"],
    "permissions": [
      "ohos.permission.INTERNET"
    ],
    "abilities": [
      {
        "name": "EntryAbility",
        "srcEntry": "./ets/entryability/EntryAbility.ets",
        "description": "$string:entry_ability_desc",
        "icon": "$media:icon",
        "label": "$string:entry_ability_label",
        "startWindowIcon": "$media:icon",
        "startWindowBackground": "$color:start_window_background"
      }
    ]
  }
}