跨平台开发 / 系统课时

控制模块之间的依赖方向

控制模块之间的依赖方向

本篇解决 Flutter 项目规模扩大后模块相互引用混乱的问题。通过设计稳定的依赖方向,让业务层依赖抽象能力而不是具体实现,降低修改成本并提升长期维护能力。

学习目标

  • 理解 Flutter 工程中依赖方向对可维护性的影响
  • 掌握使用抽象接口隔离具体实现的方法
  • 能根据模块职责判断合理的依赖关系

为什么需要控制依赖方向

小型 Flutter 应用中,页面直接调用服务类通常不会产生明显问题。但随着项目增加多个业务模块,如果任何模块都可以自由引用其他模块,修改一个基础能力可能会影响大量页面。

稳定的项目结构通常遵循由上层业务依赖下层能力,而不是底层反向依赖业务。例如订单页面可以调用订单服务,但订单服务不应该知道某个具体页面的存在。

Flutter 模块依赖方向分层示意图

使用抽象隔离实现

控制依赖方向的关键是让调用方依赖接口,而把具体实现放在更靠下的位置。例如用户模块需要读取用户信息时,业务代码只关心用户仓库接口,不关心数据来自网络还是本地缓存。

下面是一个简单的 Dart 示例,展示领域层定义接口,基础设施层提供实现:

dart
abstract class UserRepository {
  Future<String> getUserName(String id);
}

class ApiUserRepository implements UserRepository {
  @override
  Future<String> getUserName(String id) async {
    return 'user-$id';
  }
}

class UserController {
  final UserRepository repository;

  UserController(this.repository);

  Future<void> loadUser() async {
    final name = await repository.getUserName('001');
    print(name);
  }
}

void main() async {
  final controller = UserController(ApiUserRepository());
  await controller.loadUser();
}

预期输出

text
user-001

在这个结构中,UserController 不需要知道 ApiUserRepository 的存在。未来替换为本地数据库实现时,只需要提供新的接口实现即可。

常见依赖错误

实际开发中常见的问题是业务层直接创建具体对象:

dart
final repository = ApiUserRepository();

这种写法会把业务逻辑和网络实现绑定在一起,导致测试困难,也增加替换成本。

更合理的方式是通过构造参数、依赖注入框架或工厂方法传入实现,让模块之间保持松耦合。

什么时候不必过度抽象

并不是所有类都需要接口。如果一个组件只有单一用途、生命周期短,并且没有替换或测试需求,引入额外抽象反而会增加理解成本。

控制依赖方向的目标不是增加文件数量,而是在变化频繁的位置建立稳定边界,让业务变化不会持续扩散到整个工程。

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

目录与阅读设置

阅读设置

17

记录一个想法

控制模块之间的依赖方向

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

登录哪都通