Команды CLI

Вы можете использовать интерфейс командной строки (CLI) Astro для разработки, сборки и предварительного просмотра проекта из терминала.

Команды astro

Используйте CLI, запуская одну из команд, описанных ниже, через ваш менеджер пакетов. За командой могут следовать флаги, которые настраивают её поведение.

Чаще всего вы будете использовать команду astro dev, которая запускает сервер разработки:

npm

npx astro dev

pnpm

pnpm astro dev

Yarn

yarn astro dev

Список доступных команд

Введите astro --help в терминале для вывода всех доступных команд:

Commands
              add  Добавить интеграцию.
            build  Собрать проект.
            check  Проверить проект на ошибки.
       create-key  Создать ключ шифрования.
               dev  Запустить сервер разработки.
              docs  Открыть документацию в браузере.
              info  Показать информацию об окружении.
           preview  Предварительный просмотр сборки.
              sync  Генерация типов TypeScript.
       preferences  Настройка предпочтений пользователя.
         telemetry  Настройка телеметрии.

astro dev

Запускает локальный сервер разработки. Он использует технологию Hot Module Replacement (HMR) для мгновенного обновления браузера при сохранении изменений.

Горячие клавиши в терминале:

• s + enter: синхронизация слоев контента.
• o + enter: открыть сайт в браузере.
• q + enter: остановить сервер.

astro build

Собирает ваш сайт для развертывания. По умолчанию создает статические файлы в папке dist/. Если используется SSR, создает файлы для сервера.

astro preview

Запускает локальный сервер для просмотра содержимого папки dist/. Это позволяет проверить итоговую сборку перед деплоем.

astro check

Запускает диагностику проекта (например, проверку типов в .astro файлах). Полезно для автоматизации проверок в CI (Continuous Integration).

astro sync

Генерирует типы TypeScript для модулей Astro. Это необходимо для работы IntelliSense и проверки типов в коллекциях контента, Astro DB и переменных окружения.

astro add

Автоматически добавляет интеграцию в ваш конфиг и устанавливает необходимые зависимости.

npx astro add tailwind

Общие флаги

--root <path>

Указывает путь к корню проекта.

--config <path>

Указывает путь к файлу конфигурации (по умолчанию astro.config.mjs).

--port <number>

Указывает порт для сервера (по умолчанию 4321).

--host

Разрешает серверу слушать все сетевые адреса, что удобно для тестирования с мобильных устройств.

--verbose

Включает подробное логирование, полезное при отладке.