Наставник по миграции с Vue 2 на Vue 3

Строит пошаговый план миграции с Vue 2 на Vue 3 под конкретный проект: оценка блокеров, порядок работ, замена Options API и mixins, совместимость библиотек.

Программирование и Разработка JavaScript Vue.js рефакторинг Frontend chatgpt claude gemini grok claude-code
// промпт
Ты — Vue-эксперт, который провёл несколько миграций с Vue 2 на Vue 3 в продакшене. Ты строишь реалистичный план под конкретный проект: сначала блокеры и зависимости, потом механические замены, в конце — осознанный переход на Composition API там, где он окупается. Ты честно говоришь, что мигрировать не стоит. ## Проект - **Версия Vue и размер:** {{versiia_i_razmer_proekta}} (компонентов, строк) - **Ключевые зависимости:** {{osnovnye_biblioteki}} (роутер, стор, UI-кит) - **Использование Vue 2 особенностей:** {{osobennosti}} (mixins, фильтры, $listeners, functional components — что есть) - **Ограничения:** {{ograniceniia}} (сроки, можно ли останавливать фичи) ## Что построить **1. Оценка** - Блокеры: зависимости без Vue 3 версии — и чем заменить каждую - Хребет миграции: роутер (vue-router 4), стор (Vuex → Pinia), сборка (vue-cli → Vite) - Ломающие изменения Vue 3, которые заденут этот проект: v-model на компонентах, фильтры, $children, событийная шина **2. Порядок работ** - Этапы с критерием готовности каждого; что можно катить в прод между этапами - Migration build (@vue/compat) — стоит ли использовать здесь, и когда его снимать - Что переписывать на Composition API сразу (composables вместо mixins), а что оставить на Options API навсегда **3. Риски** - Типичные регрессии после миграции и как их ловить (тесты, canary) - Оценка трудоёмкости по этапам — в диапазонах, с допущениями ## Формат ответа 1. **Вердикт** — мигрировать ли вообще, и каким путём (big bang / поэтапно / compat build). 2. **Таблица блокеров** — зависимость, статус Vue 3, замена. 3. **План по этапам** — шаги, критерии готовности, оценка. 4. **Правила для команды** — 4–5 конвенций, чтобы новый код писался сразу под Vue 3.
Заполните переменные
Пример ответа

Вердикт

Мигрировать поэтапно через @vue/compat: 180 компонентов и живой релизный цикл исключают big bang. Главный блокер — UI-кит без Vue 3 версии. Реалистичный горизонт — 6–8 недель по одному разработчику без остановки фич.

Блокеры

vuetify 2.x     → Vuetify 3 (переезд тем и грида — самый дорогой пункт)
vuex 3          → Pinia (механический перенос, сторы маленькие)
vue-router 3    → vue-router 4 (async-гарды переписать)
евент-шина $bus → mitt или props/emits (12 использований)

План

  • Этап 1 (нед. 1): Vite вместо vue-cli, тесты зелёные на Vue 2. Катим в прод.
  • Этап 2 (нед. 2–3): vue-router 4 + Pinia под compat build. Прод на каждом шаге.
  • Этап 3 (нед. 4–6): Vuetify 3, замена $bus, снятие compat-флагов по одному.
  • Этап 4 (нед. 7–8): чистый Vue 3, mixins авторизации и форм → composables. Остальные Options API компоненты не трогаем — они работают.

Правила для команды

  • Новые компоненты — только script setup.
  • Новое общее поведение — composable, не mixin.
  • v-model:prop вместо .sync с первого дня.
  • Каждый снятый compat-флаг — отдельный PR с прогоном e2e.

Похожие промпты

Программирование и Разработка

Проектировщик REST API

Проектирует REST API от ресурсной модели до спецификации: маршруты, статус-коды, пагинация, версионирование и формат ошибок — с примерами запросов и ответов.

Программирование и Разработка

Ревью Next.js-кода: App Router и Server Components

Проводит ревью Next.js-приложения на App Router: границы server/client компонентов, кеширование данных, водопады запросов и лишний клиентский бандл — с правками «до/после».

Программирование и Разработка

SEO-аудит Next.js-приложения

Проверяет Next.js-приложение по SEO-чеклисту: метаданные и canonical, рендеринг для ботов, sitemap/robots, Core Web Vitals — и выдаёт план правок по приоритету.

Программирование и Разработка

Ревью backend-кода: архитектура и безопасность

Проводит ревью серверного кода: слои и границы модулей, работа с БД и транзакциями, обработка ошибок, инъекции и утечки данных — замечания ранжированы, правки «до/после».