跨平台开发 / 系统课时

按功能模块组织项目目录

按功能模块组织项目目录

中大型 Flutter 应用最容易遇到的问题是代码数量增长后难以定位和修改。本篇将比较按类型与按功能组织目录的差异,并建立以业务模块为中心、便于长期维护的项目结构。

学习目标

  • 理解按类型目录和 feature 目录的组织方式差异
  • 掌握 Flutter 项目按功能模块拆分的基本原则
  • 能根据应用规模设计可持续扩展的目录结构

为什么传统按类型目录会失控

很多 Flutter 初始项目会按照文件职责分类,例如把所有页面放到 pages,所有组件放到 widgets,所有模型放到 models。这种方式在页面较少时很直观,但随着业务增长,一个功能相关的文件会被分散到多个目录。

例如用户登录功能可能包含登录页面、表单组件、状态管理、接口请求、数据模型和测试文件。按类型组织后,开发者需要在多个目录之间跳转才能理解一个完整功能。

使用 feature 方式组织代码

Feature 目录以业务能力作为边界,把一个功能需要的页面、状态、数据和组件放在一起。常见结构如下:

CODE
lib/
├── core/
│   ├── network/
│   ├── theme/
│   └── utils/
├── features/
│   ├── auth/
│   │   ├── data/
│   │   ├── domain/
│   │   ├── presentation/
│   │   └── auth.dart
│   └── profile/
│       ├── data/
│       ├── domain/
│       └── presentation/
└── main.dart

features 用于放业务模块,core 放多个模块共享的基础能力。这样修改登录功能时,主要工作都集中在 auth 目录内。

Flutter feature 目录分层结构示意图

feature 划分的边界原则

不是所有代码都应该放进 feature。划分目录时可以遵循以下规则:

  • 只服务一个业务场景的代码放入对应 feature。
  • 多个业务都会使用的能力放入 core 或共享模块。
  • 不因为文件数量少而过早拆分复杂层级。

例如日期格式化工具、网络客户端、主题配置通常属于公共能力,而订单页面、支付流程、用户资料页面属于具体业务模块。

根据项目规模选择结构

小型应用可以先保持简单结构,例如:

CODE
lib/
├── pages/
├── widgets/
└── services/

当功能数量增加后,再迁移到 feature 结构。不要为了追求架构完整,在只有几个页面时创建大量空目录。

中大型应用通常更适合 feature 结构,因为团队成员可以围绕业务模块协作,减少不同功能之间的代码耦合。

选择目录结构的核心目标不是让文件夹看起来复杂,而是让开发者能够快速回答“这个功能在哪里实现”和“修改它会影响什么”。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

按功能模块组织项目目录

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通