跨平台开发 / 系统课时

抽离公共组件和基础能力

抽离公共组件和基础能力

本篇解决 Flutter 项目中公共代码不断堆积的问题。通过识别真正稳定的复用逻辑,将组件、工具和服务放入合适位置,避免 shared 目录逐渐变成无法维护的杂物箱。

学习目标

  • 理解公共代码抽离的判断标准
  • 掌握组件、工具和服务的职责划分方式
  • 能设计清晰的基础能力目录

判断什么应该成为公共能力

项目中经常出现“复制几次就抽公共”的情况,但复用次数不是唯一标准。真正适合抽离的代码通常满足以下条件:多个模块需要使用、变化频率低、职责明确。

例如统一按钮样式、日期格式化规则、网络请求封装属于稳定能力,而某个页面专用的数据转换逻辑通常不应该放入公共目录。

可以通过以下问题判断:

  • 修改这个能力时,是否希望所有使用方一起变化?
  • 这个能力是否表达一个明确的业务或技术职责?
  • 新成员能否快速理解它提供什么能力?

区分组件、工具和服务

公共代码常见的三类职责不同,目录设计也应该体现区别。

类型 适合内容 不适合内容
组件 通用按钮、输入框、布局组件 某个页面专用区域
工具 日期转换、字符串处理、格式化函数 包含业务状态的逻辑
服务 网络请求、存储、设备能力封装 页面交互代码

例如,一个通用加载按钮应该负责展示状态和处理点击交互,而不应该直接调用某个业务接口。

Flutter 公共能力分层结构示意图

设计清晰的公共目录

公共目录命名应该反映职责,而不是简单使用一个无限扩张的 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 或公共组件目录。

抽离后的验证方式

完成公共能力整理后,可以通过以下方式检查设计是否合理:

  • 删除一个业务模块时,公共目录是否仍然有存在价值
  • 公共组件是否可以在多个页面独立使用
  • 基础服务是否依赖具体业务代码

公共代码的价值不在于数量更多,而在于稳定边界更清晰。好的抽离会减少重复,也会让团队更容易理解工程结构。

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

目录与阅读设置

阅读设置

17

记录一个想法

抽离公共组件和基础能力

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

登录哪都通