Communitygithub.com

你可能不需要 Effect

基于官方文档的 React useEffect 最佳实践。适用于编写/审查 useEffect、对派生值使用 useState、数据获取或状态同步的场景。教导何时不需要使用 Effect 以及更好的替代方案。

你可能不需要 Effect 是什么?

这份技能文档基于 React 官方文档,教导开发者如何正确使用 useEffect。其核心理念是:Effect 是与外部系统同步的转义口,如果涉及的不是外部系统,通常不需要使用 Effect。文档通过“不要做”和“应该做”的对比表格,清晰地列出了常见的错误用法(如在 useState + useEffect 中派生状态、在 useEffect 中缓存计算等)及其正确替代方案(渲染时计算、使用 useMemo、使用 key 属性等)。此外,文档提供了一个决策树,帮助开发者根据触发场景(用户交互、组件显示、状态变化等)选择正确的工具(事件处理函数、Effect、渲染时计算、key 属性)。支持所有 React 平台(Web/移动端/服务端),适用于 React 项目的代码编写与审查。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/jarrodwatts/claude-code-config/react-useeffect

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

你可能不需要 Effect 是做什么的?

Effect 是 React 的一个转义口。它们让你与外部系统同步。如果没有外部系统参与,你不需要使用 Effect。

快速参考

场景不要这样做应该这样做
从 props/state 派生状态useState + useEffect在渲染期间计算
开销大的计算useEffect 来缓存useMemo
在 prop 变化时重置状态使用 useEffect 调用 setState使用 key prop
用户事件响应使用 useEffect 监听状态直接在事件处理函数中处理
通知父组件状态变化使用 useEffect 调用 onChange在事件处理函数中调用
获取数据使用 useEffect 不带清理使用 useEffect 带清理 或者 框架机制

何时需要使用 Effect

  • 与外部系统同步(非 React 小部件、浏览器 API)
  • 订阅外部存储(尽可能使用 useSyncExternalStore)
  • 分析/日志:因为组件显示而运行
  • 数据获取:带适当清理(或使用框架内置机制)

何时不需要 Effect

  1. 转换数据用于渲染 —— 在顶层计算,自动重新运行
  2. 处理用户事件 —— 使用事件处理函数,你确切知道发生了什么
  3. 派生状态 —— 直接计算:const fullName = firstName + ' ' + lastName
  4. 链式状态更新 —— 在事件处理函数中一次性计算所有下一个状态

决策树

需要对某些事情作出响应?
├── 用户交互(点击、提交、拖拽)?
│   └── 使用事件处理函数
├── 组件出现在屏幕上?
│   └── 使用 Effect(外部同步、分析)
├── props/state 变化且需要派生值?
│   └── 在渲染期间计算
│       └── 开销大?使用 useMemo
└── 当 prop 变化时需要重置状态?
    └── 在组件上使用 key prop

详细指导

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

相关技能