跨平台开发 / 系统课时
按功能模块组织项目目录
按功能模块组织项目目录
中大型 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.dartfeatures 用于放业务模块,core 放多个模块共享的基础能力。这样修改登录功能时,主要工作都集中在 auth 目录内。

feature 划分的边界原则
不是所有代码都应该放进 feature。划分目录时可以遵循以下规则:
- 只服务一个业务场景的代码放入对应 feature。
- 多个业务都会使用的能力放入
core或共享模块。 - 不因为文件数量少而过早拆分复杂层级。
例如日期格式化工具、网络客户端、主题配置通常属于公共能力,而订单页面、支付流程、用户资料页面属于具体业务模块。
根据项目规模选择结构
小型应用可以先保持简单结构,例如:
CODE
lib/
├── pages/
├── widgets/
└── services/当功能数量增加后,再迁移到 feature 结构。不要为了追求架构完整,在只有几个页面时创建大量空目录。
中大型应用通常更适合 feature 结构,因为团队成员可以围绕业务模块协作,减少不同功能之间的代码耦合。
选择目录结构的核心目标不是让文件夹看起来复杂,而是让开发者能够快速回答“这个功能在哪里实现”和“修改它会影响什么”。
按自己的节奏,确认真正理解。