跨平台开发 / 系统课时
控制模块之间的依赖方向
控制模块之间的依赖方向
本篇解决 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();这种写法会把业务逻辑和网络实现绑定在一起,导致测试困难,也增加替换成本。
更合理的方式是通过构造参数、依赖注入框架或工厂方法传入实现,让模块之间保持松耦合。
什么时候不必过度抽象
并不是所有类都需要接口。如果一个组件只有单一用途、生命周期短,并且没有替换或测试需求,引入额外抽象反而会增加理解成本。
控制依赖方向的目标不是增加文件数量,而是在变化频繁的位置建立稳定边界,让业务变化不会持续扩散到整个工程。
按自己的节奏,确认真正理解。