Первые шаги

Vite+ — это унифицированный инструментарий и точка входа для веб-разработки.

Он объединяет Vite, Vitest, Oxlint, Oxfmt, Rolldown, tsdown и Vite Task в одном пакете vite-plus, обеспечивая чрезвычайно быстрый инструментарий для фронтенд-разработки.

Vite+ также поставляется с глобальным CLI vp, который управляет Node.js и менеджерами пакетов и упрощает использование Vite+ в разных проектах. Вы можете использовать любой из CLI независимо, но мы рекомендуем использовать их вместе.

Если у вас уже есть проект на Vite, выполните vp migrate, чтобы перенести его на Vite+, или передайте своему агенту для написания кода наш промпт для миграции.

Создаёте проект с помощью ИИ-ассистента? Посмотрите и скопируйте готовый промпт настройки:

Установка vp глобально

Приведённые ниже команды устанавливают глобальный CLI vp, который управляет Node.js и менеджерами пакетов и делает vp доступным во всех проектах. Если вам нужен только фронтенд-инструментарий в одном проекте, вместо этого можно установить локальный CLI проекта.

macOS / Linux

curl -fsSL https://vite.plus | bash

Windows

irm https://vite.plus/ps1 | iex

Альтернативно, скачайте и запустите vp-setup.exe.

Предупреждение SmartScreen

vp-setup.exe ещё не подписан цифровой подписью. Ваш браузер может показать предупреждение при скачивании. Нажмите «...» → «Сохранить» → «Сохранить в любом случае», чтобы продолжить. Если Windows Defender SmartScreen заблокирует файл при запуске, нажмите «Дополнительные сведения» → «Выполнить в любом случае».

Сценарии установки и vp-setup.exe читают переменные окружения, такие как VP_VERSION и VP_HOME.

Если вы используете Nushell с пользовательскими каталогами XDG, перед установкой ознакомьтесь с требованиями Nushell при запуске.

После установки откройте новый терминал и выполните:

vp help

ИНФОРМАЦИЯ

Vite+ будет управлять вашей глобальной средой выполнения Node.js и менеджером пакетов. Если вы хотите отключить это поведение, выполните vp env off. Если вы решите, что Vite+ вам не подходит, введите vp implode, но, пожалуйста, поделитесь с нами своим отзывом.

Используете менее распространённую платформу (архитектуру процессора, ОС)?

Предварительно собранные бинарные файлы распространяются для следующих платформ (сгруппированы по уровням поддержки платформ Node.js v24):

• Уровень 1
  • Linux x64 glibc (x86_64-unknown-linux-gnu)
  • Linux arm64 glibc (aarch64-unknown-linux-gnu)
  • Windows x64 (x86_64-pc-windows-msvc)
  • macOS x64 (x86_64-apple-darwin)
  • macOS arm64 (aarch64-apple-darwin)
• Уровень 2
  • Windows arm64 (aarch64-pc-windows-msvc)
• Экспериментальные
  • Linux x64 musl (x86_64-unknown-linux-musl)
• Другие
  • Linux arm64 musl (aarch64-unknown-linux-musl)

Если предварительно собранный бинарный файл недоступен для вашей платформы, установка завершится ошибкой.

На Alpine Linux (musl) вам нужно установить libstdc++ перед использованием Vite+:

apk add libstdc++

Это требуется, потому что управляемая среда выполнения Node.js из неофициальных сборок зависит от стандартной библиотеки GNU C++.

Быстрый старт

После установки глобального CLI создайте проект, установите зависимости и используйте команды по умолчанию:

vp create # Создать новый проект
vp install # Установить зависимости
vp dev # Запустить dev-сервер
vp check # Форматировать, линтить, проверять типы
vp test # Запустить JavaScript-тесты
vp build # Собрать для продакшена

Также можно запустить vp без аргументов, чтобы открыть интерактивную командную строку. В конфигурации, использующей только локальный CLI, запускайте те же команды через менеджер пакетов, например pnpm exec vp check.

Основные команды

Vite+ охватывает полный цикл фронтенд-разработки — от создания проекта до разработки, проверок, тестирования и сборки для продакшена. Большинство команд доступны в обоих вариантах; команды для управления окружением на уровне машины и самостоятельного управления требуют глобального CLI.

Установка проекта

• vp create создаёт новые приложения, пакеты и монорепозитории.
• vp migrate переносит существующие проекты на Vite+.
• vp install устанавливает зависимости с помощью подходящего менеджера пакетов.
• vp add, vp remove, vp update, vp dedupe, vp outdated, vp list, vp why и vp info охватывают остальные операции рабочего процесса управления пакетами.
• vp link, vp unlink, vp rebuild и vp pm <command> предоставляют низкоуровневые операции менеджера пакетов.

Инструментарий проекта

• vp check запускает форматирование, линтинг и проверку типов вместе.
• vp lint и vp fmt напрямую запускают соответствующие проверки.
• vp test запускает тесты с помощью Vitest.
• vp dev запускает сервер разработки на базе Vite.
• vp build собирает приложения, а vp preview позволяет локально просмотреть production-сборку.
• vp pack собирает библиотеки или автономные артефакты.
• vp toolchain показывает активный инструментарий проекта; используйте --global, чтобы вместо этого проверить глобальную установку.
• vp run запускает задачи по рабочим пространствам с кэшированием.
• vp cache clean очищает записи кэша задач.
• vp exec запускает локальные бинарные файлы проекта, а vp dlx и vpx скачивают и запускают бинарные файлы пакетов.
• vp config устанавливает диспетчер Git-хуков и настраивает интеграцию с агентами.
• vp hooks управляет диспетчером Git-хуков, а vp staged запускает проверки для проиндексированных файлов.
• Руководство по монорепозиториям посвящено структуре многопакетных проектов и соответствующим командам.

Глобальный CLI

• vp env управляет окружением Node.js и менеджеров пакетов, а vp node запускает скрипты в определённом окружении.
• vp upgrade обновляет саму глобальную установку vp.
• vp implode удаляет глобальную установку vp и связанные с Vite+ данные с вашего компьютера.

Рабочий процесс

• Интеграция с IDE, CI и Docker охватывают распространённые среды разработки и развёртывания.

Справочник

• Решение проблем посвящен распространённым проблемам с командами, конфигурацией и интеграцией.

ИНФОРМАЦИЯ

Vite+ поставляется с множеством предопределённых команд, таких как vp build, vp test и vp dev. Эти команды встроенные и не могут быть изменены. Если вы хотите запустить команду из сценариев package.json, используйте vp run <command> или vpr <command>.

Подробнее о vp run.