flutter_errors — правило для Claude Code: ошибки Flutter и установка
Правило flutter_errors помогает разбирать типичные ошибки Flutter-разметки: от переполнения Row до неверного вызова setState во время сборки. Пригодится при поиске причин сбоя в дереве виджетов.
MIT ★ 674 обновлён 2026-10-29
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rulesЧто делает flutter_errors
Правило связывает сообщения об ошибках Flutter с вероятными причинами в разметке и коде. При RenderFlex overflowed оно предлагает проверить ограничения дочерних виджетов в Row и Column; для прокручиваемого списка внутри Column — задать ограничение высоты. Для TextField рассматривается ограничение ширины, а setState и showDialog предлагается вызывать не прямо из build.
Также правило охватывает повторное подключение ScrollController к нескольким прокручиваемым виджетам и ошибку RenderBox was not laid out. Для диагностики указаны Flutter Inspector и проверка ограничений виджетов. Вызов setState из build — конкретная причина ошибки, которую правило помогает устранить.
Какие задачи решает
- найти причину переполнения
RowилиColumn - задать высоту
ListViewвнутриColumn - ограничить ширину
TextField - перенести вызов
setStateизbuild - исправить повторное подключение
ScrollControllerк спискам
Примеры запросов агенту
- Разбери ошибку
RenderFlex overflowedи предложи исправление для моегоRow. - Проверь, почему
ListViewвнутриColumnполучает неограниченную высоту. - Найди причину ошибки
setState called during buildв этом виджете.
Как установить flutter_errors
1Через маркетплейс плагинов
/plugin marketplace add evanca/flutter-ai-rules/plugin install flutter-ai-skills@flutter-ai-rules2Вручную: положить файлы
.claude/rules/flutter_errors.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/flutter_errors.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/flutter_errors.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/flutter_errors.mdВручную: положить файлы
.clinerules/flutter_errors.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о flutter_errors
Как установить flutter_errors в Claude Code?
Выполните команды по порядку: /plugin marketplace add evanca/flutter-ai-rules, затем /plugin install flutter-ai-skills@flutter-ai-rules. Файл правила находится по пути .claude/rules/flutter_errors.md.
Что делает flutter_errors?
Правило подсказывает причины распространённых ошибок Flutter, связанных с ограничениями размеров, прокруткой и вызовами состояния во время сборки.
Как правило помогает при ошибке неограниченной высоты?
Для ListView или другого прокручиваемого виджета внутри Column нужно задать ограничение высоты, например через Expanded или SizedBox.
Исходный текст
flutter_errors.md · MIT
### Common Flutter Errors 1. If you get a "RenderFlex overflowed" error, check if a `Row` or `Column` contains unconstrained widgets. Fix by wrapping children in `Flexible`, `Expanded`, or by setting constraints. 2. If you get "Vertical viewport was given unbounded height", ensure `ListView` or similar scrollable widgets inside a `Column` have a bounded height (e.g., wrap with `Expanded` or `SizedBox`). 3. If you get "An InputDecorator...cannot have an unbounded width", constrain the width of widgets like `TextField` using `Expanded`, `SizedBox`, or by placing them in a parent with width constraints. 4. If you get a "setState called during build" error, do not call `setState` or `showDialog` directly inside the build method. Trigger dialogs or state changes in response to user actions or after the build completes (e.g., using `addPostFrameCallback`). 5. If you get "The ScrollController is attached to multiple scroll views", make sure each `ScrollController` is only attached to a single scrollable widget at a time. 6. If you get a "RenderBox was not laid out" error, check for missing or unbounded constraints in your widget tree. This is often caused by using widgets like `ListView` or `Column` without proper size constraints. 7. Use the Flutter Inspector and review widget constraints to debug layout issues. Refer to the official documentation on constraints if needed.
© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules