ng-redux创建Redux Store的3种方式详解:createStoreWith、provideStore与createStore怎么选

原创2026-10-14 11:24:361,327 阅读

ng-redux创建Redux Store的3种方式详解:createStoreWith、provideStore与createStore怎么选

在 AngularJS 项目中引入 Redux 状态管理,绕不开 ng-redux 这个官方 bindings 库。它通过一个 Angular 的 Provider($ngReduxProvider)把 Redux Store 创建、中间件注入、组件连接全部串联起来。而初始化阶段最关键的一步,就是创建 Redux Store。ng-redux 提供了 3 种方式:createStoreWith、provideStore 和 createStore,它们各自解决的问题并不相同。本文带你一次性搞清楚它们的区别与适用场景,并给出一份选型速查表。

3 种方式总览:一张表看清差异

先上结论,方便你快速判断自己该用哪种:

方式 谁负责创建 Store 适用场景 控制粒度
createStoreWith ng-redux 自动创建 绝大多数项目的默认选择 中:传 reducer + 中间件数组即可
provideStore 你自己已有 Store Store 在 ng-redux 之外创建(测试、模块化) 低:只负责桥接
createStore 你通过回调函数完全掌控 需要自定义 enhancer 组合顺序、DevTools 等高级配置 高:自己写 compose/applyMiddleware

三者的实现都集中在 ngRedux.js 这一个 Provider 文件里,读懂它就等于读懂了整个初始化流程。

方式一:createStoreWith —— 90% 项目的默认选择

createStoreWith(reducer, [middlewares], [storeEnhancers], [initialState]) 是官方 Quick Start 推荐的方式。你只需要把根 reducer 和中间件数组交给它,ng-redux 会在应用启动时自动完成 combineReducers、applyMiddleware、compose 等一系列组合工作。

它的核心用法长这样(取自 counter 示例的入口文件 index.js):

angular.module('counter', [ngRedux])
  .config(($ngReduxProvider) => {
    $ngReduxProvider.createStoreWith(rootReducer, [thunk], [DevTools.instrument()]);
  })

两个容易忽略的“隐藏福利”

1. 中间件支持 Angular 依赖注入

中间件数组里的元素既可以是函数,也可以是字符串。字符串会被当作 Angular 工厂名,在运行时通过 $injector 解析(见 ngRedux.js#L67-L69)。这意味着你可以给中间件注入 $http、自定义 service 等依赖:

angular.factory('myInjectableMiddleware', myInjectableMiddleware);

// 字符串 'myInjectableMiddleware' 会在运行时被解析
$ngReduxProvider.createStoreWith(rootReducer, [thunk, 'myInjectableMiddleware']);

2. reducer 可以直接传对象

如果第一个参数是一个普通对象(key 为 reducer 名或工厂名),ng-redux 会自动对字符串 key 做 DI 解析,再帮你 combineReducers(见 ngRedux.js#L79-L93)。这样每个 reducer 都能享受依赖注入,非常优雅。

注意:digestMiddleware 永远在最后

ng-redux 会自动追加一个 digestMiddleware,负责在每次 dispatch 后触发 Angular 的 $evalAsync 消化状态变更(见 digestMiddleware.js 与 ngRedux.js#L95-L96)。你传入的中间件无需也不应该关心这一点,框架已处理。

方式二:provideStore —— 已有 Store 时的桥接方案

provideStore(store) 解决的是一个特殊问题:Store 不由 ng-redux 创建,而是从外部传入。典型场景:

  • 单元测试:测试代码里已经 createStore 好了一个带初始状态的 Store;
  • 混合项目:Store 由其他模块或脚本先创建,ng-redux 只负责“挂接”;
  • 需要复用一个配置极其复杂(热替换、HMR)的 Store 工厂。

它的工作原理值得花 30 秒理解:ng-redux 内部会创建一个“影子 Store”,并通过 providedStoreMiddleware.js 实现双向代理——

  1. ng-redux 组件 dispatch 的 action → 转发给外部真实 Store;
  2. 外部 Store 状态变化 → 通过 storeWrapper.js 订阅并回灌到影子 Store,让 $ngRedux.connect 正常响应。

这个双向桥接有完整的集成测试验证(见 ngReduxProvidedStore.spec.js),你可以放心使用:

import { createStore, combineReducers } from 'redux';

const reducer = combineReducers(reducers);
const store = createStore(reducer);

angular.module('app', [ngRedux])
  .config(($ngReduxProvider) => {
    $ngReduxProvider.provideStore(store);
  });

方式三:createStore —— 完全掌控 enhancer 组合顺序

createStore(storeCreator) 接收一个回调函数,参数是 ng-redux 解析好的 middlewares 和 storeEnhancers 两个数组,由你自己写 compose(applyMiddleware(...), ...enhancers) 来创建 Store:

$ngReduxProvider.createStore((middlewares, enhancers) => {
  return createStore(
    reducer,
    {},
    compose(applyMiddleware(thunk, ...middlewares), ...enhancers)
  );
});

什么时候需要它?

  • 你希望把某些 enhancer(如 Redux DevTools Extension)插在中间件之前而不是之后;
  • 你要用非标准的组合方式,比如自定义的 composeWithDevTools;
  • 团队规范要求 Store 创建逻辑集中在一个显式函数里,便于审查与复用。

⚠️ 官方特别强调:ng-redux 解析出的 middlewares 必须放在 applyMiddleware 的最后(因为其中包含 digestMiddleware)。上面示例中 thunk, ...middlewares 的写法正是这个要求——自定义中间件在前,ngRedux 的数组在后。

怎么选?3 步决策法

  1. Store 是现成的吗? 是 → provideStore;不是 → 进入第 2 步。
  2. 中间件/enhancer 顺序用默认就行吗? 是 → createStoreWith(默认最优解);不是 → 进入第 3 步。
  3. 需要手动控制 compose 吗? 是 → createStore 回调方式。

一句话记忆:createStoreWith 图省事、provideStore 做桥接、createStore 玩高级。

进阶小贴士:给 digest 加防抖

大型应用中 store 变更频繁时,可以用 Provider 的 config.debounce 给 digest 加防抖,避免过度触发 Angular 消化(基于 lodash.debounce):

$ngReduxProvider.config.debounce = { wait: 100, maxWait: 500 };

写在最后

三种方式本质上只是**“谁来创建 Store”**这一件事的不同答案。日常开发用 createStoreWith 就够了;遇到外部 Store 或复杂 enhancer 场景时,再切换到 provideStore / createStore。更多 API 细节可参考 index.d.ts 中的类型定义(INgReduxProvider 接口),以及 README.md 的 Quick Start 章节。仓库内 counter 与 async 两个示例分别演示了基础用法与异步场景,是很好的上手材料。

登录后查看全文
ng-redux