React -- useState状态更新异步特性——导致获取值为旧值的问题

问题

  const [isSelecting, setIsSelecting] = useState(false);
  useEffect(() => {
    const handleKeyDown = (event) => {
      if (event.key === 'Escape') {
        if(isSelectingRef){
        //.......
          setIsSelecting(!isSelecting);
          console.log("执行了么")
        }
      }
    };
  
    window.addEventListener('keydown', handleKeyDown);
  
    return () => {
      window.removeEventListener('keydown', handleKeyDown);
    };
  }, [editor]); 

........
<Button
 size="xs"
 className={`bg-[#21242a] text-xs mt-1 mb-1 ${isSelecting?'w-20':"w-full"}`}
 onClick={() => {
  editor.isSelectingDyObTarckPoint = !editor.isSelectingDyObTarckPoint;
 document.body.style.cursor = "crosshair";
 if(editor.dyObstacleTrackPoint.length===0){
   //...........
               }
 if (isSelecting) {
                console.log("执行了么?")
                //......
              }
              setIsSelecting(!isSelecting);
            }}
          >
            {isSelecting ? "Done" : "Edit track"}
          </Button>

当时的场景，主要是为了设置一个esc快捷键，esc快捷键的逻辑功能和按钮为“Done”的时候点击效果是一样的。（主要为了方便，直接键盘操作）；
但是发现isSelecting初始值为false（按钮渲染为Edit track），在第一次点击按钮时，isSelecting设置新值为！isSelecting即为true（按钮渲染为Done）。
此时按下esc，打印出来的isSelecting为false，条件判断内的逻辑没有被执行。

导致的原因

如果点击按钮后 isSelecting 应该变成 true 但是打印出来却是 false，这是因为在日志输出时遇到了 React 的状态更新异步特性。
在 React 中，当你调用 setIsSelecting 来更新状态时，这个操作是异步的。这意味着状态不会立即更新，而是会在下次组件重新渲染时更新。因此，如果你在调用 setIsSelecting 后立即打印 isSelecting 的值，它可能还没有更新。

例如，以下代码中的 console.log 将输出状态更新之前的值：

setIsSelecting(true); 
// 这里更新了状态，但这个操作是异步的
console.log(isSelecting); 
// 这里很可能还是旧的状态值，因为状态更新是异步的

要检查状态更新之后的值，你可以使用 useEffect 钩子来“监听”isSelecting 状态的变化：

useEffect(() => {
  console.log(isSelecting); 
  // 当 isSelecting 更新后，这里会输出新值
}, [isSelecting]); 
// 依赖数组确保只有当 isSelecting 变化时才执行这个 effect

解决办法

使用useRef记录值。
要确保在 handleKeyDown 函数中捕获到最新的 isSelecting 状态值，可以使用 useRef 钩子来确保引用保持最新。因为 useRef 创建的对象会在整个组件的生命周期内保持不变，我们可以利用这一点来存储最新的状态。

import React, { useState, useEffect, useRef } from 'react';
// ...省略其他imports...

const SimpleProperties = ({ apaObject, enabledItems ,editor}) => {
  const [isSelecting, setIsSelecting] = useState(false);
  // ...省略其他状态和逻辑...

  // 使用 useRef 来跟踪当前的 isSelecting 状态。
  const isSelectingRef = useRef(isSelecting);

  // 每当 isSelecting 改变时，更新 ref 的 current 值
  useEffect(() => {
    isSelectingRef.current = isSelecting;
  }, [isSelecting]);

  // 键盘事件处理器使用 ref 来获取最新的 isSelecting 值
  const handleKeyDown = (event) => {
    if (event.key === 'Escape') {
      // 通过 isSelectingRef.current 获取最新的状态值
      if (isSelectingRef.current) {
        console.log("就是不执行")
        // ...你原有的逻辑...

        // 更新状态
        setIsSelecting(!isSelectingRef.current);
      }
    }
  };

  // 设置键盘事件监听
  useEffect(() => {
    // 添加keydown事件监听器
    window.addEventListener('keydown', handleKeyDown);
  
    // 清除事件监听器，当组件卸载时执行
    return () => {
      window.removeEventListener('keydown', handleKeyDown);
    };
  }, []); // 这里的依赖数组为空，表示 effect 只在挂载和卸载时运行

  // ...省略其他部分...
};

在这个修改版的代码中，isSelectingRef 是一个 ref 对象，它的 current 属性始终包含最新的 isSelecting 状态值。handleKeyDown 函数通过访问 isSelectingRef.current 来获取最新状态值，而不是直接从闭包中获取。这样做的好处是无论何时调用 handleKeyDown，它都能获取到最新的状态值。

请注意，设置键盘事件监听的 useEffect 中的依赖数组被设置为空（[]），意味着这个 effect 只在组件挂载时添加事件监听器，并且在组件卸载时移除。由于我们不需要响应任何特定的属性或状态的变化来重新绑定事件监听器，这样做是安全的。如果你希望对某些属性或状态做出响应，则需要相应地更新依赖数组。

进一步分析

在 React 的 useEffect 钩子中使用事件处理器时，如果事件处理器引用了组件的状态或属性，并且这些状态或属性在函数定义时的值被固定下来，那么我们就说这个事件处理器是一个闭包，并且它“捕获”了定义它时的环境。

例如，在下面的代码中：

useEffect(() => {
  const handleKeyDown = (event) => {
    if (event.key === 'Escape') {
      // 这里直接访问了 isSelecting，这个值是 handleKeyDown 函数定义时的值
      console.log(isSelecting);
    }
  };

  window.addEventListener('keydown', handleKeyDown);

  return () => {
    window.removeEventListener('keydown', handleKeyDown);
  };
}, []); // 依赖数组为空，effect 只在挂载和卸载时运行

handleKeyDown 是在 useEffect 的回调函数内部定义的。当这个 useEffect 执行时，它会创建 handleKeyDown 函数，并把当前的 isSelecting 状态“捕获”到该函数内部。这意味着无论 isSelecting 状态以后如何变化，handleKeyDown 内部看到的总会是创建它那一刻的 isSelecting 值。因为 useEffect 的依赖数组为空，所以它只在组件挂载时运行一次，而不会在 isSelecting 更新时重新运行。

要解决这个问题，通常有两种方法：

1. 将状态更新逻辑放入 useEffect 并将状态添加到依赖数组中。但这会导致注册和注销监听器的频繁操作。
2. 使用 useRef 来存储状态的最新值。因为 ref 对象是可变的，并且不会触发组件的额外渲染，所以事件处理器可以通过查看 ref 的 current 属性来访问最新值，而不依赖于闭包中捕获的旧值。

使用 useRef 的方案允许你在不重新绑定事件监听器的情况下，始终访问到最新的状态值。这就是为什么在之前的答案中我建议使用 useRef 的原因。

---

后续遇到的新问题

在handledown中使用isSelecting方法没有反应，这意味着 setIsSelecting 可能没有被正确调用，或者 isSelecting 状态的更新因为某些原因没能触发重新渲染。以下是一些解决这个问题的步骤：

1. 确认事件监听器被触发:
   首先确认 handleKeyDown 函数确实在按下 Esc 键时被触发。可以通过在该函数内部加入一个 console.log 来确认。

const handleKeyDown = (event) => {
  if (event.key === 'Escape') {
    console.log('Escape key pressed');
    setIsSelecting(current => !current); // 使用函数式更新
    // 其他逻辑...
  }
};

2. 检查 useEffect 的依赖数组:
   请确保你在 useEffect 中注册和注销事件监听器的代码不受其他状态或属性的影响。如果你把 handleKeyDown 定义在 useEffect 内部，并且该 useEffect 没有依赖项，则不需要担心闭包问题。

3. 使用函数式 setState:
   当你想要基于当前状态来更新状态时，使用函数式 setState 可以避免因闭包导致的过时状态值引用问题。(使用该方法解决了)

setIsSelecting(current => !current);

分析
闭包捕获的是函数定义时所在作用域内的变量，并且这些捕获的变量不会随着外部作用域中同名变量的变化而更新。这是因为函数通过闭包保持对其创建时环境的引用，就像它们“记住”了那些变量及其当时的值。

下面是一个简单的闭包例子来说明这个概念：

function createFunction() {
  let value = 1;
  return function() {
    console.log(value);
  };
}

let myFunction = createFunction();
value = 2;
myFunction(); // 输出 1, 而不是 2

在上述示例中，myFunction 是在 createFunction 中创建的，它“记住”了变量 value 当时的值（1），尽管后来该变量的值已经改变。当调用 myFunction() 时，它仍然输出 1。

在 React 组件的上下文中，每次组件重新渲染时都会生成新的函数实例和变量。但如果你使用 useEffect 钩子并且依赖数组为空（[]），或者将依赖项排除在 useEffect 外，事件处理器将只会在第一次渲染时被创建一次，它会捕获并“记住”当时的状态和属性值。

例如：

useEffect(() => {
  const handleClick = () => {
    console.log(value); // 这里的 value 是 handleClick 被创建时的值
  };

  document.addEventListener('click', handleClick);
  return () => {
    document.removeEventListener('click', handleClick);
  };
}, []); // 空依赖数组使得 useEffect 只在组件挂载时运行

即使组件重新渲染并且 value 的值发生变化，handleClick 定义时捕获的 value 仍然是旧值，并且由于 useEffect 的依赖数组为空，handleClick 并不会重新定义。因此，无论触发多少次点击事件，handleClick 总是输出最初捕获的 value 值。

正因为如此，要确保事件处理器总能够获取到最新的状态和属性，你需要使用函数式更新（如 setState(current => current + 1)）或确保相关变量和状态作为依赖被包含在 useEffect 的依赖数组中，从而在它们更新时重新创建事件处理器。