入门 Redux

Redux 是 JavaScript 应用的状态容器，提供可预测的状态管理。

可以帮助你开发出行为稳定可预测的、运行于不同的环境（客户端、服务器、原生应用）、易于测试的应用程序。不仅于此，它还提供超爽的开发体验，比如有一个 与时间旅行调试器相结合的实时代码编辑 。

可以将 Redux 与 React 或其他视图库一起使用。它体小精悍（只有2kB，包括依赖），却有很强大的插件扩展生态。

安装 ​

Redux Toolkit ​

Redux Toolkit 是我们官方推荐的编写 Redux 逻辑的方法。它围绕 Redux 核心，并包含我们认为对于构建 Redux 应用必不可少的软件包和功能。Redux Toolkit 建立在我们建议的最佳实践中，简化了大多数 Redux 任务，防止了常见错误，并使编写 Redux 应用程序更加容易。

RTK 包含了有助于简化许多常见场景的工具，包括 配置 Store ， 创建 reducer 并编写 immutable 更新逻辑 ， 甚至还包含 一次性创建整个 State 的 “Slice” 。

无论你是一个想要开发第一个 Redux 应用的新手，还是想要简化已有应用经验老道的老手， Redux Toolkit 都能帮你写出更好的 Redux 代码.

Redux Toolkit 提供 NPM 软件包，可与模块捆绑器或 Node 应用程序一起使用，安装方式如下：

# NPM
npm install @reduxjs/toolkit

# Yarn
yarn add @reduxjs/toolkit

创建一个 React Redux 应用 ​

官方推荐的使用 React 和 Redux 创建新应用的方式是使用 官方 Redux+JS 模版 或 Redux+TS 模板 ，它基于 Create React App ，利用了 Redux Toolkit 和 Redux 与 React 组件的集成.

# Redux + Plain JS template
npx create-react-app my-app --template redux

# Redux + TypeScript template
npx create-react-app my-app --template redux-typescript

Redux 核心库 ​

Redux 核心库同样有 NPM 软件包，可与模块捆绑器或 Node 应用程序一起使用，安装方式如下：

# NPM
npm install redux

# Yarn
yarn add redux

还有一个使用方式是通过预编译的 UMD 包，定义了 window.Redux 这个全局变量。UMD 包可以通过 <script> tag 直接使用。

想要获取更多信息，查看 安装 .

基础示例 ​

应用的整体全局状态以对象树的方式存放于单个 store 。 唯一改变状态树（state tree）的方法是创建 action ，一个描述发生了什么的对象，并将其 dispatch 给 store。 要指定状态树如何响应 action 来进行更新，你可以编写纯 reducer 函数，这些函数根据旧 state 和 action 来计算新 state。

import { createStore } from 'redux'

/**
 * 这是一个 reducer 函数：接受当前 state 值和描述“发生了什么”的 action 对象，它返回一个新的 state 值。
 * reducer 函数签名是 : (state, action) => newState
 *
 * Redux state 应该只包含普通的 JS 对象、数组和原语。
 * 根状态值通常是一个对象。 重要的是，不应该改变 state 对象，而是在 state 发生变化时返回一个新对象。
 *
 * 你可以在 reducer 中使用任何条件逻辑。 在这个例子中，我们使用了 switch 语句，但这不是必需的。
 * 
 */
function counterReducer(state = { value: 0 }, action) {
  switch (action.type) {
    case 'counter/incremented':
      return { value: state.value + 1 }
    case 'counter/decremented':
      return { value: state.value - 1 }
    default:
      return state
  }
}

// 创建一个包含应用程序 state 的 Redux store。
// 它的 API 有 { subscribe, dispatch, getState }.
let store = createStore(counterReducer)

// 你可以使用 subscribe() 来更新 UI 以响应 state 的更改。
// 通常你会使用视图绑定库（例如 React Redux）而不是直接使用 subscribe()。
// 可能还有其他用例对 subscribe 也有帮助。

store.subscribe(() => console.log(store.getState()))

// 改变内部状态的唯一方法是 dispatch 一个 action。
// 这些 action 可以被序列化、记录或存储，然后再重放。
store.dispatch({ type: 'counter/incremented' })
// {value: 1}
store.dispatch({ type: 'counter/incremented' })
// {value: 2}
store.dispatch({ type: 'counter/decremented' })
// {value: 1}

你需要使用 action 这个普通对象来描述发生了什么，而不是直接改变 state。然后，编写一个名为 reducer 的特殊函数，来决定如何基于 action 来更新整个应用的状态树。

在典型的 Redux 应用程序中，只有一个 store 以及一个根 reducer 函数。随着应用程序的增长，您可以将根 reducer 拆分为较小的 reducer，分别在状态树的不同部分上进行运行。这就像在 React 应用程序中只有一个根组件一样，但是它是由许多小组件组成的。

对于简单的计数器应用来说，这种架构看起来过度设计，但是这种模式的优点在于它可以很好地扩展到大型和复杂的应用程序。还可以基于此设计出功能非常强大的开发者工具，因为可以跟踪每个 action 以及状态变更。你可以记录用户会话并仅通过重播每个 action 来重现它们。

Redux Toolkit 示例 ​

Redux Toolkit 简化了编写 Redux 逻辑和设置 store 的过程。 使用 Redux Toolkit，相同的逻辑如下所示：

import { createSlice, configureStore } from '@reduxjs/toolkit'

const counterSlice = createSlice({
  name: 'counter',
  initialState: {
    value: 0
  },
  reducers: {
    incremented: state => {
      // Redux Toolkit 允许在 reducers 中编写 "mutating" 逻辑。
      // 它实际上并没有改变 state，因为使用的是 Immer 库，检测到“草稿 state”的变化并产生一个全新的
      // 基于这些更改的不可变的 state。
      state.value += 1
    },
    decremented: state => {
      state.value -= 1
    }
  }
})

export const { incremented, decremented } = counterSlice.actions

const store = configureStore({
  reducer: counterSlice.reducer
})

// 可以订阅 store
store.subscribe(() => console.log(store.getState()))

// 将我们所创建的 action 对象传递给 `dispatch`
store.dispatch(incremented())
// {value: 1}
store.dispatch(incremented())
// {value: 2}
store.dispatch(decremented())
// {value: 1}

Redux Toolkit 使我们可以编写更精短且更易于阅读的代码，同时仍然遵循同样的 Redux 规范和数据流。

学习 Redux ​

我们有多种资源可帮助您学习Redux。

Redux 基础教程 ​

Redux 基础教程 是一个“自上而下”的教程，使用推荐的最新 API 和最佳实践来教“如何以正确的方式使用 Redux”。建议从这个教程开始。该教程从最初的原理开始，没有任何抽象地讲授“Redux 工作原理”，以及 Redux 标准规范存在背后的原因。

学习流行的 Redux 流 ​

Redux 维护者 Mark Erikson 在“与 Jason 一起学习”节目中，解释了我们今天如何推荐使用 Redux。该节目用一个实时编码的示例应用程序，展示了如何用 Typescript 编写 Redux Toolkit 和 React-Redux hooks，以及新的 RTK Query 数据获取 API。

请参阅 the "Learn Modern Redux" show notes page 以获取脚本和示例应用程序源的链接。

附加教程 ​

• Redux 仓库包含几个示例项目，展示了如何使用 Redux 的各个方面。几乎所有示例都具有对应的 CodeSandbox 案例，CodeSandbox是可以在线使用的交互式代码平台。请参阅 示例页面
• Redux 作者 Dan Abramov 的 免费 "Redux 入门" 视频系列 和 Building React Applications with Idiomatic Redux Egghead.io 上的视频教程
• Redux 维护者 Mark Erikson 的 "Redux Fundamentals" 大会演讲 and "Redux Fundamentals" 工作坊 PPT
• Dave Ceddia 的文章 面向初学者的完整 React Redux 教程

其他资源 ​

• Redux FAQ 包含了使用 Redux 的很多常见问题， "技巧" 文档章节 讲述了如何处理衍生数据、测试、组织 reducer 逻辑，和减少样板代码。
• Redux 维护者 Mark Erikson's "Practical Redux" 系列教程 演示了 React Redux 实际开发中用到的中级和高级技术，（也可以在 Educative.io 找到可交互的课程 ）。
• React/Redux 链接列表 对一系列链接做了分类，包括： reducers and selectors 、 管理副作用 、 Redux 架构和最佳实践 等等。
• 我们的社区已经创建了数千个与 Redux 相关的库、插件和工具。 "生态" 文档页面 列出了我们的推荐，这里还有一个更完整的列表： Redux addons catalog 。

帮助和讨论 ​

Reactiflux Discord 社区 的 #redux channel 是有关学习和使用 Redux 所有问题的官方资源。Reactiflux 浏览、提问和学习的好地方 - 快来加入我们吧!

你也可以用在 #redux 标签 在 Stack Overflow 上提问。

如果你有 bug report 或者需要留下其他反馈， 请在 Github repo 上提出问题

你需要使用 Redux 吗？ ​

虽然 Redux 是一个很有价值的管理状态工具，但还是要考虑下它是否适合你的场景。 不要仅仅因为有人说过应该使用 Redux 而使用 - 应该花一些时间来了解使用它的潜在好处和取舍 。

当遇到如下问题时，建议开始使用 Redux：

• 你有很多数据随时间而变化
• 你希望状态有一个唯一确定的来源（single source of truth）
• 你发现将所有状态放在顶层组件中管理已不可维护

有关如何使用Redux的更多想法，请参见：

• Redux FAQ: 为什么要用 Redux？

• You Might Not Need Redux

• Redux 之道，Part 1 - 实现和目的

• Redux 之道，Part 2 - 实践和原理

• Redux 常见问题