在 React 中，将 setMode 作为参数传入自定义函数时若报错“setMode is not a function”，通常是因为该函数未被正确定义或未从 useState 正确解构获取。本文详解错误成因、正确用法及最佳实践。
在 react 中，将 `setmode` 作为参数传入自定义函数时若报错“setmode is not a function”，通常是因为该函数未被正确定义或未从 `usestate` 正确解构获取。本文详解错误成因、正确用法及最佳实践。
你遇到的错误 setMode is not a function 并非语法问题，而是调用上下文缺失导致的典型逻辑错误。原始代码：
export const Mode = (mode, setMode) => {
mode === "dark" ? setMode("light") : setMode("dark");
};
这段代码本身语法合法，但它脱离了 React 的 Hook 调用规则和组件生命周期：setMode 是 useState 返回的 setter 函数，必须在 React 组件内部（或自定义 Hook 中）被定义并使用；而 Mode 函数若被直接调用（如 Mode("light", undefined)），传入的 setMode 参数很可能为 undefined 或非函数值——这正是错误根源。
✅ 正确做法是：在组件作用域内定义状态与 setter，并将逻辑封装为可复用的事件处理函数，例如：
import React, { useState } from 'react';
const ThemeToggle = () => {
const [mode, setMode] = useState('light');
// ✅ 正确：在组件内定义，确保 setMode 可访问
const toggleMode = (currentMode) => {
setMode(prev => prev === 'dark' ? 'light' : 'dark');
};
return (
<div>
<p>Current mode: <strong>{mode}</strong></p>
<button onclick="{()"> toggleMode(mode)}>
Switch to {mode === 'dark' ? 'Light' : 'Dark'} Mode
</button>
</div>
);
};
export default ThemeToggle;
? 关键要点：
-
setMode不能凭空传入，它必须由useState在组件中初始化后获得； - 若需复用切换逻辑，推荐封装为组件内函数（如
toggleMode），而非试图“外部注入” setter； - 更简洁写法可直接使用函数式更新，避免依赖传入的
currentMode参数（因其可能过期）：const toggleMode = () => setMode(prev => prev === 'dark' ? 'light' : 'dark');
并在 JSX 中直接绑定：
<button onclick="{toggleMode}">...</button>。
⚠️ 注意事项：
- 不要在非 React 组件/非 Hook 环境中调用
useState或尝试手动构造setMode； - 避免将
setMode作为 props 深层透传（易引发依赖混乱），优先通过状态提升或 Context 管理跨组件状态； - 若需抽象逻辑，应创建自定义 Hook（如
useThemeToggle），而非裸函数。
总结：React 的状态 setter 是闭包绑定的函数，其有效性严格依赖于 useState 的调用上下文。确保 setMode 始终在合法的 Hook 调用链中生成与使用，是避免此类错误的根本原则。
