跨平台开发 / 系统课时
抽离公共组件和基础能力
抽离公共组件和基础能力
本篇解决 Flutter 项目中公共代码不断堆积的问题。通过识别真正稳定的复用逻辑,将组件、工具和服务放入合适位置,避免 shared 目录逐渐变成无法维护的杂物箱。
学习目标
- 理解公共代码抽离的判断标准
- 掌握组件、工具和服务的职责划分方式
- 能设计清晰的基础能力目录
判断什么应该成为公共能力
项目中经常出现“复制几次就抽公共”的情况,但复用次数不是唯一标准。真正适合抽离的代码通常满足以下条件:多个模块需要使用、变化频率低、职责明确。
例如统一按钮样式、日期格式化规则、网络请求封装属于稳定能力,而某个页面专用的数据转换逻辑通常不应该放入公共目录。
可以通过以下问题判断:
- 修改这个能力时,是否希望所有使用方一起变化?
- 这个能力是否表达一个明确的业务或技术职责?
- 新成员能否快速理解它提供什么能力?
区分组件、工具和服务
公共代码常见的三类职责不同,目录设计也应该体现区别。
| 类型 | 适合内容 | 不适合内容 |
|---|---|---|
| 组件 | 通用按钮、输入框、布局组件 | 某个页面专用区域 |
| 工具 | 日期转换、字符串处理、格式化函数 | 包含业务状态的逻辑 |
| 服务 | 网络请求、存储、设备能力封装 | 页面交互代码 |
例如,一个通用加载按钮应该负责展示状态和处理点击交互,而不应该直接调用某个业务接口。

设计清晰的公共目录
公共目录命名应该反映职责,而不是简单使用一个无限扩张的 shared 文件夹。一个常见结构如下:
text
lib/
core/
network/
storage/
utils/
widgets/
app_button.dart
app_text_field.dart
features/
user/
order/预期结果
text
core 保存跨业务基础能力
widgets 保存可复用界面组件
features 保存独立业务模块这种划分可以让开发者快速判断新代码应该放在哪里,也减少不同业务模块之间的直接耦合。
避免 shared 目录失控
一个常见反模式是所有暂时无法归类的代码都放入 shared:
text
shared/
user_helper.dart
order_utils.dart
temp_service.dart
common_manager.dart当目录出现大量名称模糊的文件时,说明这些代码可能没有明确职责。
更好的方式是重新分析代码归属。如果它服务某个业务,就放回对应 feature;如果它提供基础技术能力,再进入 core 或公共组件目录。
抽离后的验证方式
完成公共能力整理后,可以通过以下方式检查设计是否合理:
- 删除一个业务模块时,公共目录是否仍然有存在价值
- 公共组件是否可以在多个页面独立使用
- 基础服务是否依赖具体业务代码
公共代码的价值不在于数量更多,而在于稳定边界更清晰。好的抽离会减少重复,也会让团队更容易理解工程结构。
按自己的节奏,确认真正理解。