GetX：关键概念，Flutter 导航与 DI

什么是 GetX？

GetX — 一个用于 Flutter 的全能微框架，解决三个主要开发任务：状态管理（State Management）、导航（Routing）和依赖注入（DI）。GetX 不需要 Stream、ChangeNotifier、Builder 或订阅——所有响应式功能由基于 GetValue 和 GetStream 的 Rx 包装器提供，其运行速度比 ChangeNotifier 快数十倍。

GetX 定位为 Provider + Navigator + get_it/kiwi 组合的替代方案。无需安装三个不同的包并编写 10 行配置，GetX 一行代码即可提供一切：GetMaterialApp 代替 MaterialApp。导航通过 Get.to(NextScreen()) 无需 BuildContext 即可工作，DI 通过 Get.put(Service()) 无需 Provider 树即可工作。

根据 Flutter Community Survey 2025，GetX 用于 43% 的 Flutter 项目。选择的主要原因：最低入门门槛（5 分钟即可学会）、无样板代码（代码比 Provider 或 BLoC 缩短 60-70%）和快速 MVP 开发。批评者指出其违反了职责分离原则，并且调试困难。

响应式状态：Obx 和 Rx

Obx — GetX 的响应式 widget，当 Rx 变量更改时重建。Obx 不需要订阅、dispose 或 Builder 函数——只需将 widget 包装在 Obx 中并在内部使用 Rx 变量即可。Obx 自动跟踪使用了哪些 Rx 变量，并且仅在它们更改时重绘。

class CounterController extends GetxController {
  final count = 0.obs;
  void increment() => count++;
}

class CounterScreen extends StatelessWidget {
  final controller = Get.put(CounterController());

  @override
  Widget build(context) => Obx(() => Text('${controller.count}'));
}

Rx 变量：.obs — 将任何值包装到 Rx 对象中的 getter。GetX 提供类型化的 Rx 类：RxInt、RxString、RxDouble、RxBool、RxList、RxMap。所有 Rx 变量都像普通原语一样行为：count++、name.value = 'Hello'、items.add(item)。更改会自动通知 Obx 订阅者。

GetBuilder — 无 Rx 的 Obx 替代方案，通过手动调用 update() 工作。GetBuilder.filter — 根据 ID 键进行定点更新。Obx 更快（自动依赖跟踪），GetBuilder 更可预测（显式更新调用）。建议简单场景使用 Obx，复杂 widget 使用 GetBuilder。

GetController 和生命周期

GetxController — 支持生命周期的业务逻辑基类。GetxController 有以下方法：onInit()（初始化）、onReady()（第一帧后）、onClose()（清理资源）。与 ChangeNotifier 和 StateNotifier 不同，GetxController 自动管理订阅：当页面销毁时，所有 Rx 变量和 Workers 都会取消订阅。

class AuthController extends GetxController {
  final user = Rx<User?>(null);
  final isLoading = false.obs;

  @override
  void onInit() {
    ever(isLoading, (_) => print('Loading: $isLoading'));
    super.onInit();
  }

  Future<void> login(String email, String password) async {
    isLoading.value = true;
    user.value = await api.login(email, password);
    isLoading.value = false;
  }
}

Workers — GetX 的响应式工具：ever（每次更改时调用）、once（仅在第一次更改时调用）、debounce（带延迟，用于搜索框）、interval（每秒不超过 N 次，用于分析）。Workers 解决典型任务：字段验证（debounce）、分析（once）、同步（ever）。Workers 在调用 onClose() 时自动取消订阅，防止内存泄漏。

导航和路由

GetX 导航 不需要 BuildContext 即可在屏幕之间切换。代替 Navigator.push(context, MaterialPageRoute(...))，使用 Get.to(NextScreen()) — 从任何位置调用，包括没有 BuildContext 访问权限的 Controller。GetX 支持命名路由、动画、中间件和无需 MaterialPageRoute 的参数传递。

// 普通导航
Get.to(ProfileScreen());
Get.back();
Get.off(LoginScreen()); // 替换当前路由
Get.offAll(HomeScreen()); // 清空堆栈

// 命名路由
Get.toNamed('/profile', arguments: 'user123');
Get.offNamed('/login');

// Middleware
GetPage(
  name: '/profile',
  page: () => ProfileScreen(),
  middlewares: [AuthMiddleware()],
)

GetPage 和 GetPages：GetX 在 MaterialApp 中使用 GetPages 代替 routes。Middleware — 在进入屏幕前进行授权检查、重定向、分析。Transition — 内置过渡动画：fadeIn、zoom、leftToRight、topToBottom。Bindings — 在进入路由时初始化 Controller 和依赖项的类。Bindings 解决了懒初始化问题：Controller 仅在屏幕打开时创建。

使用 GetX 进行依赖注入

Get.put — 在 DI 容器中注册实例。Get.find — 从容器中获取实例。Get.lazyPut — 懒初始化（在第一次 find 调用时创建）。Get.putAsync — 异步初始化（用于带有 init 的服务）。Get.delete — 从容器中删除（路由销毁时由 Bindings 自动调用）。

GetX DI — Flutter 中最简单的 DI 容器。无需 Provider 树，无需 Module，无需 Scope。在 Controller 或 main.dart 中的 Get.put(Repository()) 使对象通过 Get.find<Repository>() 在应用程序的任何位置可用。GetX DI 还支持 标记（tag: 'api'）和 持久性（permanent: true）以防止删除。

GetX：最佳实践和性能

GetX 性能 基于通过 GetStream（针对 Flutter 优化的专有 Stream 实现）工作的 Rx 包装器。根据 GetX 基准测试，Rx 变量在频繁更新（30+ fps）时比 ChangeNotifier 快 2-3 倍，比 BLoC 快 5-7 倍。GetX 不将 BuildContext 用于订阅，从而消除了导航时 widget 树的重建。

最佳实践：对于具有大量子元素（列表、表格）的 widget，使用 GetBuilder 而不是 Obx。按功能模块划分 Controller，而不是每个页面一个巨大的 Controller。使用 Bindings 初始化 Controller，而不是在 build 方法中使用 Get.put。GetView — 一个简化的 StatelessWidget，通过 controller 访问 Controller，无需 Get.find。

已知限制：GetX 使用全局变量（Get.find、Get.to），可能使测试变得困难。通过 GetX 模拟依赖项需要在测试之间调用 Get.replace() 或 Get.reset()。建议使用 Get.testMode = true 进行隔离。GetX 不推荐用于需要严格架构和清晰层边界的应用程序——在这种情况下，BLoC 或带有代码生成的 Riverpod 更可取。