# perf-never-set-state-in-useframe

Правило perf-never-set-state-in-useframe для react-three-fiber: не вызывать setState внутри useFrame, потому что это даёт перерисовку на каждом кадре. Вместо состояния React — мутация ref.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 4719 у репозитория
- Автор: zebbern
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/r3f-best-practices/rules/perf-never-set-state-in-useframe.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/perf-never-set-state-in-useframe

## Что делает

\`useFrame` из react-three-fiber срабатывает на каждом кадре. Если внутри стоит `setState`, React пересобирает компонент с той же частотой, и почти всё время кадра уходит на это. Правило требует другого: держать объект Three.js в `ref` и менять `ref.current.position` напрямую. Такой мутации React не видит и перерисовку не запускает.

Внутри разобраны два примера, плохой и хороший, плюс вариант с `delta`: поворот задаётся в радианах в секунду и не зависит от частоты кадров. Несколько осей сразу ставятся через `position.set` и `rotation.set`. Для Zustand есть отдельный случай: чтение через `getState()` не подписывает компонент, поэтому цель можно брать прямо в `useFrame` и подтягивать через `lerp`.

Состояние React всё ещё нужно для интерфейса. Анимированный меш выносят в отдельный компонент, а счёт или подпись держат рядом в обычном: обновление счёта тогда не трогает меш. Искать по проекту стоит любой `useFrame` с `setState` внутри, потому что именно такой вызов и роняет кадры.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/perf-never-set-state-in-useframe.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/perf-never-set-state-in-useframe.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/perf-never-set-state-in-useframe.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/perf-never-set-state-in-useframe.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/perf-never-set-state-in-useframe.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/r3f-best-practices/rules/perf-never-set-state-in-useframe.md

## Когда брать
- найти `setState` внутри `useFrame` и убрать лишние перерисовки
- перевести покадровую анимацию с состояния React на мутацию `ref`
- сделать скорость поворота независимой от частоты кадров через `delta`
- читать цель из Zustand без подписки компонента на стор
- вынести состояние интерфейса из анимированного компонента

## Примеры запросов агенту
- Проверь `Scene.jsx`: если внутри `useFrame` вызывается `setState`, перепиши на мутацию `ref`.
- Анимация дёргается. Посмотри, не обновляется ли состояние компонента на каждом кадре.
- Переведи вращение на `delta`, а состояние оставь только для счёта в интерфейсе.

## Похожие
- [react-three-fiber-architect](https://affpapa.org/nevibecode/agents/react-three-fiber-architect.md) — субагент · ★ 1428 у репозитория
- [improve-threejs](https://affpapa.org/nevibecode/skills/improve-threejs.md) — скилл · 451 установка
- [threejs-animation](https://affpapa.org/nevibecode/skills/iart-ai-threejs-animation.md) — скилл · 2300 установок
- [threejs-perf](https://affpapa.org/nevibecode/skills/threejs-perf.md) — скилл · 753 установки
- [threejs-react-three-fiber](https://affpapa.org/nevibecode/skills/threejs-react-three-fiber.md) — скилл · 6800 установок
- [react-three-fiber](https://affpapa.org/nevibecode/skills/react-three-fiber.md) — скилл · 4300 установок

Из того же набора: [zebbern/claude-code-guide](https://affpapa.org/nevibecode/by/zebbern/claude-code-guide.md) — 86 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
