AI 摘要：这是一个 ESLint 插件，用来帮助开发者发现并避免在 React 项目中错误或不必要使用 useEffect 的场景。通过提供多条规则，它能让代码逻辑更清晰、性能更高、Bug 更少，尤其对初学者有帮助，同时对有经验的开发者也可能带来新的启发。

1. 插件介绍与背景
• 核心思想是减少不必要的 React useEffect 使用
• 改善代码可读性，提高性能，减少逻辑错误
• 推荐新手使用，同时对老手也有价值

2. 安装与配置
• 提供 npm 和 yarn 的安装方法
• 支持 .eslintrc 旧版配置与 eslint.config.js 新版配置
• 可与 eslint-plugin-react-hooks 一起使用以获得更精准的依赖分析

3. 核心规则（Rules）
• no-derived-state：禁止在 effect 中存储衍生 state
• no-chain-state-updates：禁止在 effect 中链式更新 state
• no-event-handler：禁止用 effect 来做事件处理逻辑
• no-adjust-state-on-prop-change：禁止在 prop 改变时用 effect 调整 state
• no-reset-all-state-on-prop-change：禁止在 prop 改变时通过 effect 重置所有 state
• no-pass-live-state-to-parent & no-pass-data-to-parent：禁止在 effect 中向父组件传递 state 或数据
• no-initialize-state：禁止在 effect 中初始化 state
• no-manage-parent：禁止纯依赖 props 的 effect
• no-empty-effect：禁止空的 effect 定义
• 默认推荐配置会启用全部规则作为 warning

4. 测试与实践
• 项目中包含 (in)valid 例子用于规则验证
• 强调插件并非覆盖所有情况，但尽量减少误报

5. 社区与反馈
• 鼓励开发者提出问题和改进建议
• 插件以减少 false positives（误报）为设计目标，即时存在偶发的漏报 (false negatives)

6. 学习资源
• React useEffect 官方文档
• You Might Not Need an Effect
• Synchronizing with Effects
• Separating Events from Effects
• Lifecycle of Reactive Effects

GitHub

GitHub - NickvanDyke/eslint-plugin-react-you-might-not-need-an-effect: Catch unnecessary React useEffect hooks to make your code…

Catch unnecessary React useEffect hooks to make your code simpler, faster, and safer. - NickvanDyke/eslint-plugin-react-you-might-not-need-an-effect