Flutter 依赖注入详解

什么是依赖注入

依赖注入（Dependency Injection，简称 DI）是一种设计模式，它允许我们将对象的创建和使用分离开来。通过依赖注入，我们可以：

降低代码耦合度
提高代码可测试性
实现更好的代码重用
简化对象管理

Flutter 中的依赖注入方式

构造函数注入

class UserService {
  final ApiClient apiClient;
  final DatabaseHelper dbHelper;

  UserService(this.apiClient, this.dbHelper);

  Future<User> getUser(String id) async {
    // 使用 apiClient 和 dbHelper
    return User();
  }
}

Provider 注入

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MultiProvider(
      providers: [
        Provider<ApiClient>(create: (_) => ApiClient()),
        Provider<DatabaseHelper>(create: (_) => DatabaseHelper()),
        ProxyProvider2<ApiClient, DatabaseHelper, UserService>(
          update: (_, apiClient, dbHelper, __) =>
              UserService(apiClient, dbHelper),
        ),
      ],
      child: MaterialApp(
        home: HomePage(),
      ),
    );
  }
}

GetIt 服务定位器

final getIt = GetIt.instance;

void setupDependencies() {
  getIt.registerSingleton<ApiClient>(ApiClient());
  getIt.registerSingleton<DatabaseHelper>(DatabaseHelper());
  getIt.registerFactory<UserService>(
    () => UserService(getIt<ApiClient>(), getIt<DatabaseHelper>()),
  );
}

// 使用
class HomePage extends StatelessWidget {
  final userService = getIt<UserService>();

  @override
  Widget build(BuildContext context) {
    return Container();
  }
}

依赖注入的最佳实践

1. 接口分离

abstract class IApiClient {
  Future<dynamic> get(String endpoint);
  Future<dynamic> post(String endpoint, dynamic data);
}

class ApiClient implements IApiClient {
  @override
  Future<dynamic> get(String endpoint) async {
    // 实现
    return null;
  }

  @override
  Future<dynamic> post(String endpoint, dynamic data) async {
    // 实现
    return null;
  }
}

2. 模块化注入

class AppModule {
  static void setup() {
    getIt.registerSingleton<IApiClient>(ApiClient());
    getIt.registerSingleton<IDatabaseHelper>(DatabaseHelper());
  }
}

class ServiceModule {
  static void setup() {
    getIt.registerFactory<IUserService>(
      () => UserService(getIt<IApiClient>(), getIt<IDatabaseHelper>()),
    );
  }
}

3. 测试中的依赖注入

class MockApiClient implements IApiClient {
  @override
  Future<dynamic> get(String endpoint) async {
    return {'mockData': true};
  }

  @override
  Future<dynamic> post(String endpoint, dynamic data) async {
    return {'success': true};
  }
}

void setupTestDependencies() {
  getIt.registerSingleton<IApiClient>(MockApiClient());
  // 其他测试依赖
}

常见问题和解决方案

1. 循环依赖

避免循环依赖的方法：

使用中介者模式
重构代码结构
使用事件总线

2. 作用域管理

class ScopedDependencies extends StatefulWidget {
  final Widget child;

  ScopedDependencies({required this.child});

  @override
  _ScopedDependenciesState createState() => _ScopedDependenciesState();
}

class _ScopedDependenciesState extends State<ScopedDependencies> {
  @override
  void initState() {
    super.initState();
    setupScopedDependencies();
  }

  @override
  void dispose() {
    cleanupScopedDependencies();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return widget.child;
  }
}

3. 性能考虑

合理使用单例
懒加载依赖
及时释放资源

实战：GetX 项目里，我没引入第二套 DI

我做的几个电商/物流类小项目（旅行类应用、美妆电商项目这类）统一用的 GetX 栈（get ^4.7.2），依赖注入就直接用 GetX 自带的 Get.put()/Get.find()：页面三件套（index/controller/view）里，controller 之间的依赖就这么拿，没再引入 get_it 或 provider。

取舍理由很简单：一个项目只用一套 DI 机制。GetX 已经把路由、状态管理、依赖注入绑在一起了，再叠 get_it 就是两种心智模型打架——排查”这个实例到底是谁创建的、生命周期归谁管”时会非常痛苦。代价是和 GetX 深度绑定，哪天换框架就得重写；但对小团队的 CRUD 型 App，这个代价几乎不存在。这篇讲的 provider、GetIt 方案更适合没用 GetX 的项目：选型先看你站哪条技术线，别在一个项目里混用两套。

总结

依赖注入是 Flutter 应用程序开发中的重要概念，它可以帮助我们：

编写更清晰、可维护的代码
提高代码的可测试性
实现更好的关注点分离
简化依赖管理

通过合理使用依赖注入，我们可以构建更健壮、可维护的 Flutter 应用程序。选择合适的依赖注入方式，遵循最佳实践，可以帮助我们更好地管理应用程序的复杂性。