React 中 onChange 事件触发多次的解析

在 React 应用开发中，一个常见的困惑是：输入框内容变化时，onChange 事件处理函数会被调用两次。本文将分析这种现象，特别是当 state 使用对象类型时，为何会触发两次调用，而使用基本数据类型（如数字）时只会触发一次。

问题示例：

import React, { useState } from "react";

export default function Child() {
  const [state, setState] = useState({});

  const onChange = (event) => {
    console.log("onChange", state); //此处打印两次
    setState({...state, [event.target.name]: event.target.value});
  };

  return (
    <div>
      <input type="text" name="myInput" onChange={onChange} />
    </div>
  );
}

在这个例子中，每次输入变化，onChange 函数和 console.log 语句都会执行两次。

问题根源：React 严格模式

这并非代码错误或环境问题，而是 React 的 严格模式 (StrictMode) 的设计特性。在开发环境中启用严格模式，React 会故意进行两次渲染，以帮助开发者尽早发现潜在问题。

严格模式会对某些函数进行双重调用（仅限于应为纯函数的函数）。第一次渲染用于检测副作用，第二次渲染才是实际的 DOM 更新。当 state 为对象类型时，由于对象是引用类型，React 会将其视为可能存在副作用，从而触发双重渲染和调用。而基本数据类型由于没有副作用，则只会渲染一次。

解决方案

解决方法取决于你的需求：

• 生产环境： 在生产环境中，严格模式默认禁用，因此这个问题不会出现。

• 开发环境： 如果在开发环境中需要避免双重调用，可以考虑以下几种方法：

  • 使用 useCallback 钩子： 将 onChange 函数用 useCallback 包裹，可以避免不必要的重新渲染和重复调用。

    const onChange = useCallback((event) => {
        console.log("onChange", state);
        setState({...state, [event.target.name]: event.target.value});
    }, [state, setState]);

  • 检查并避免不必要的 state 更新： 确保你的 setState 调用只在必要时进行，避免无意义的重复更新。 例如，可以使用函数式更新来避免不必要的重新渲染：

    setState(prevState => ({...prevState, [event.target.name]: event.target.value}));

  • 禁用严格模式 (不推荐): 可以在你的组件中禁用严格模式，但这会失去严格模式带来的潜在问题检测能力，因此不推荐。

总结

onChange 事件在 React 中触发多次，通常是由于开发环境下的严格模式导致的双重渲染。理解其原因，并根据实际情况选择合适的解决方案，可以有效地解决这个问题，并提高代码质量。 使用 useCallback 或函数式更新是推荐的解决方法，可以保持严格模式带来的好处，同时避免不必要的重复渲染和函数调用。