ng-redux创建Redux Store的3种方式详解:createStoreWith、provideStore与createStore怎么选
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 实现双向代理——
- ng-redux 组件 dispatch 的 action → 转发给外部真实 Store;
- 外部 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 步决策法
- Store 是现成的吗? 是 →
provideStore;不是 → 进入第 2 步。 - 中间件/enhancer 顺序用默认就行吗? 是 →
createStoreWith(默认最优解);不是 → 进入第 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 两个示例分别演示了基础用法与异步场景,是很好的上手材料。