排错

这里会列出常见的问题和对应的解决方案。虽然使用 React 做示例，即使你使用要其它库仍然会有帮助。

dispatch action 后什么也没有发生

有时，你 dispatch action 后，view 却没有更新。这是为什么呢？可能有下面几种原因。

永远不要直接修改 reducer 的参数

如果你想修改 Redux 给你传入的 state 或 action，请住手！

Redux 假定你永远不会修改 reducer 里传入的对象。任何时候，你都应该返回一个新的 state 对象。即使你没有使用 Immutable 这样的库，也要保证做到不修改对象。

不变性（Immutability）可以让 react-redux 高效的监听 state 的细粗度更新。它也让 redux-devtools 能提供“时间旅行”这类强大特性。

例如，下面的 reducer 就是错误的，因为它改变了 state：

function todos(state = [], action) {
  switch (action.type) {
  case 'ADD_TODO':
    // 错误！这会改变 state.actions。
    state.actions.push({
      text: action.text,
      completed: false
    });
  case 'COMPLETE_TODO':
    // 错误！这会改变 state.actions[action.index].
    state.actions[action.index].completed = true;
  }

  return state
}

应该重写成这样：

function todos(state = [], action) {
  switch (action.type) {
  case 'ADD_TODO':
    // 返回新数组
    return [...state, {
      text: action.text,
      completed: false
    }];
  case 'COMPLETE_TODO':
    // 返回新数组
    return [
      ...state.slice(0, action.index),
      // 修改之前复制数组
      Object.assign({}, state[action.index], {
        completed: true
      }),
      ...state.slice(action.index + 1)
    ];
  default:
    return state;
  }
}

虽然需要写更多代码，但是让 Redux 变得可具有可预测性和高效。如果你想减少代码量，你可以用一些辅助方法类似 React.addons.update 来让这样的不可变转换操作变得更简单：

// 修改前
return [
  ...state.slice(0, action.index),
  Object.assign({}, state[action.index], {
    completed: true
  }),
  ...state.slice(action.index + 1)
]

// 修改后
return update(state, {
  [action.index]: {
    completed: {
      $set: true
    }
  }
});

最后，如果需要更新 object，你需要使用 Underscore 提供的 _.extend 方法，或者更好的，使用 Object.assign 的 polyfill

要注意 Object.assign 的使用方法。例如，在 reducer 里不要这样使用 Object.assign(state, newData)，应该用 Object.assign({}, state, newData)。这样它才不会覆盖以前的 state。

你也可以通过使用 Babel 阶段 1 模式来开启 ES7 对象的 spread 操作：

// 修改前：
return [
  ...state.slice(0, action.index),
  Object.assign({}, state[action.index], {
    completed: true
  }),
  ...state.slice(action.index + 1)
]

// 修改后：
return [
  ...state.slice(0, action.index),
  { ...state[action.index], completed: true },
  ...state.slice(action.index + 1)
]

注意还在实验阶段的特性注定经常改变，最好不要在大的项目里过多依赖它们。

不要忘记调用 dispatch(action)

如果你定义了一个 action 创建函数，调用它并不会自动 dispatch 这个 action。比如，下面的代码什么也不会做：

TodoActions.js

export function addTodo(text) {
  return { type: 'ADD_TODO', text };
}

AddTodo.js

import { Component } from 'react';
import { addTodo } from './TodoActions';

class AddTodo extends Component {
  handleClick() {
    // 不起作用！
    addTodo('Fix the issue');
  }

  render() {
    return (
      <button onClick={() => this.handleClick()}>
        Add
      </button>
    );
  }
}

它不起作用是因为你的 action 创建函数只是一个返回 action 的函数而已。你需要手动 dispatch 它。我们不能在定义时把 action 创建函数绑定到指定的 Store 上，因为应用在服务端渲染时需要为每个请求都对应一个独立的 Redux store。

解法是调用 store 实例上的 dispatch() 方法。

handleClick() {
  // 生效！（但你需要先以某种方式拿到 store）
  store.dispatch(addTodo('Fix the issue'));
}

如果组件的层级非常深，把 store 一层层传下去很麻烦。因此 react-redux 提供了 connect 这个 高阶组件，它除了可以帮你监听 Redux store，还会把 dispatch 注入到组件的 props 中。

修复后的代码是这样的：

import { Component } from 'react';
import { connect } from 'react-redux';
import { addTodo } from './TodoActions';

class AddTodo extends Component {
  handleClick() {
    // 生效！
    this.props.dispatch(addTodo('Fix the issue'));
  }

  render() {
    return (
      <button onClick={() => this.handleClick()}>
        Add
      </button>
    );
  }
}

// 除了 state，`connect` 还把 `dispatch` 放到 props 里。
export default connect(AddTodo, state => ({}))

如果你想的话也可以把 dispatch 手动传给其它组件。

其它问题

在 Slack Reactiflux 里的 redux 频道里提问，或者提交一个 issue。如果问题终于解决了，请把解法写到文档里，以便别人遇到同样问题时参考。