use-immer 最佳实践：从基础到高级的完整教程

2026-02-06 05:24:41作者：范垣楠Rhoda

在 React 开发中，状态管理是一个永恒的话题。use-immer 作为 immer 库的 React Hooks 版本，为开发者提供了一种优雅的方式来处理不可变状态。这个强大的工具让你能够以可变的方式编写代码，同时保持不可变性带来的所有好处。

🚀 什么是 use-immer？

use-immer 是一个 React Hook，它结合了 immer 的不可变数据操作能力和 React Hooks 的简洁性。通过 use-immer，你可以直接在 draft 上修改状态，而不需要担心破坏不可变性原则。

核心优势：

✅ 简化复杂对象的更新操作
✅ 保持代码的可读性和可维护性
✅ 避免深拷贝带来的性能问题
✅ 与 React 生态完美集成

📦 快速安装与配置

安装 use-immer 非常简单，只需要一个命令：

npm install immer use-immer

或者使用 yarn：

yarn add immer use-immer

🎯 useImmer 基础用法

管理简单对象状态

useImmer 的基本用法与 useState 非常相似，但提供了更强大的更新能力：

import { useImmer } from 'use-immer';

function UserProfile() {
  const [user, updateUser] = useImmer({
    name: '张三',
    age: 25,
    address: {
      city: '北京',
      street: '朝阳区'
    }
  });

  // 更新用户名
  const updateUserName = (newName) => {
    updateUser(draft => {
      draft.name = newName;
    });
  };

  // 增加年龄
  const celebrateBirthday = () => {
    updateUser(draft => {
      draft.age++;
    });
  };
}

处理嵌套数据结构

use-immer 在处理嵌套数据时尤其强大：

const [company, updateCompany] = useImmer({
  name: '科技公司',
  departments: [
    {
      name: '研发部',
      employees: ['张三', '李四']
    }
  ]
});

// 添加新员工
updateCompany(draft => {
  draft.departments[0].employees.push('王五');

🔧 useImmerReducer 高级用法

对于更复杂的状态管理场景，useImmerReducer 提供了类似 Redux 的 reducer 模式：

import { useImmerReducer } from 'use-immer';

const initialState = { count: 0 };

function counterReducer(draft, action) {
  switch (action.type) {
    case 'INCREMENT':
      draft.count++;
      break;
    case 'DECREMENT':
      draft.count--;
      break;
    case 'RESET':
      return initialState;
  }
}

function Counter() {
  const [state, dispatch] = useImmerReducer(counterReducer, initialState);
  
  return (
    <div>
      <span>计数: {state.count}</span>
      <button onClick={() => dispatch({ type: 'INCREMENT' })}>+</button>
      <button onClick={() => dispatch({ type: 'DECREMENT' })}>-</button>
      <button onClick={() => dispatch({ type: 'RESET' })}>重置</button>
    </div>
  );
}

💡 性能优化技巧

1. 避免不必要的重渲染

使用 useCallback 包装更新函数：

const updateUser = useCallback((updater) => {
  setUser(produce(updater));
}, []);

// 或者直接使用 useImmer 的返回值
const [user, updateUser] = useImmer(initialState);

2. 合理使用冻结功能

use-immer 内部会自动冻结状态，确保状态的不可变性：

// 在 src/index.ts 中的实现
const [val, updateValue] = useState(() =>
  freeze(
    typeof initialValue === 'function' ? initialValue() : initialValue,
    true
  )
);

🛠️ 实际项目中的应用场景

表单状态管理

处理复杂表单时，use-immer 能够显著简化代码：

const [form, updateForm] = useImmer({
  personalInfo: {
    name: '',
    email: '',
    phone: ''
  },
  preferences: {
    newsletter: false,
    notifications: true
  }
});

// 更新表单字段
const handleInputChange = (field, value) => {
  updateForm(draft => {
    // 直接修改嵌套属性
    draft.personalInfo[field] = value;
  });
};

购物车功能实现

const [cart, updateCart] = useImmer({
  items: [],
  total: 0,
  discount: 0
});

// 添加商品到购物车
const addToCart = (product) => {
  updateCart(draft => {
    draft.items.push(product);
    draft.total += product.price;
  });
};