Что такое Vercel Doctor?
Сократите расходы на Vercel, сканируя кодовую базу Next.js на наличие затратных паттернов.
Vercel Doctor — это специализированный инструмент диагностики для проектов Next.js, развёрнутых на Vercel. Он сканирует вашу кодовую базу на паттерны, увеличивающие счёт — длительность функций, некешируемые маршруты, неоптимизированные изображения и многое другое — а затем выставляет оценку из 100 с конкретными рекомендациями по исправлению. Рекомендации подстраиваются под обнаруженную мажорную версию Next.js.
Быстрый старт
Запустите для своего проекта
npx -y vercel-doctor@latest .Вот и всё. Без установки, без настройки. Инструмент сканирует кодовую базу и выводит оценку с диагностикой.
Исправьте проблемы
Каждое диагностическое сообщение содержит пояснение: что нужно изменить и почему. Исправляйте сначала правила с наибольшим влиянием — ошибки перед предупреждениями.
Перезапустите для проверки
npx -y vercel-doctor@latest . --diffИспользуйте --diff на feature-ветках, чтобы сканировать только изменённые файлы.
Что проверяется
Vercel Doctor выполняет два прохода анализа параллельно:
- Линтинг счетов — правила на основе AST и паттернов, обнаруживающие затратные паттерны Next.js и Vercel
- Обнаружение мёртвого кода — поиск неиспользуемых файлов, экспортов и типов, которые раздувают бандл и замедляют холодный старт
Категории правил
| Категория | Правила | Что обнаруживает |
|---|---|---|
| Длительность функций | 3 | Последовательные await, блокирующее логирование, непараллельный ввод-вывод |
| Кеширование | 6 | force-dynamic, отсутствие политик кеширования, no-store fetch, побочные эффекты в GET |
| Вызовы | 2 | Клиентские fetch на страницах, агрессивная предзагрузка ссылок |
| Оптимизация изображений | 4 | Глобальное отключение unoptimized, отсутствие sizes, широкие remote-паттерны, SVG без unoptimized |
| Платформа | 8 | Тяжёлые импорты в Edge, cron-задачи, среда Bun, Fluid Compute, архив деплоя, кеш Turbopack |
| Мёртвый код | 4 | Неиспользуемые файлы, экспорты, типы и дубликаты |
Возможности
- Без настройки — работает из коробки с любым проектом Next.js
- Поддержка монорепозиториев — автоматически определяет воркспейсы, позволяет выбрать проекты для сканирования
- Режим diff — сканирование только изменённых файлов на feature-ветках
- Оценка — от 0 до 100 с метками «Отлично» / «Требует доработки» / «Критично»
- Для CI — неинтерактивный режим для автоматизированных пайплайнов
- Настраиваемость — игнорирование правил или файлов через конфигурационный файл
- AI-навык — установка в качестве навыка для Claude Code, Cursor, Codex и других
- Рекомендации с учетом версии — рекомендации подстраиваются под обнаруженную мажорную версию Next.js
Last updated on