Repolode
air-verse

air-verse/air

CLI-инструмент, который отслеживает файлы Go и автоматически пересобирает и перезапускает приложение во время разработки.

Звёзды
24,088
Форки
928
Открытые issues
14
Последний коммит
2 месяца назад

Что это?

Air — CLI-утилита для автоматической перезагрузки Go-приложений при разработке. Запустите её в корне проекта: при каждом изменении исходных файлов программа будет пересобираться и перезапускаться, так что вам не придётся останавливать и запускать её вручную. Air предназначен только для разработки и не связан с горячим развёртыванием в production.

Поведение настраивается через файл .air.toml, который можно создать командой `air init`, или с помощью флагов командной строки. Можно задать собственные команды сборки и запуска, исключить каталоги, отслеживать новые каталоги во время работы, загружать .env-файлы и передавать аргументы собранному бинарному файлу. Вместо полной пересборки правила могут запускать произвольные команды, например сборку frontend или генераторы кода вроде templ. Дополнительный прокси внедряет скрипт в HTML-ответы, чтобы браузер перезагружался после каждой сборки.

Air можно установить с помощью go install, Homebrew, Scoop, mise, скрипта установки или Docker-образа; версию проекта можно зафиксировать командой `go get -tool`.

Ключевые возможности

  • 01Автоматически пересобирает и перезапускает Go-приложение при изменении файлов
  • 02Позволяет настроить команды сборки и запуска через .air.toml или флаги CLI
  • 03Исключает подкаталоги и отслеживает вновь созданные каталоги
  • 04Правила отслеживания запускают пользовательские команды для ресурсов или генерации кода
  • 05Дополнительный прокси перезагружает браузер после каждой сборки
  • 06Загружает .env-файлы перед сборкой и запуском

Сценарии использования

  • Разработка Go-веб-сервера, например на gin, с перезагрузкой при каждом сохранении
  • Запуск сборки frontend-ресурсов или шагов templ/go generate вместе с Go-приложением
  • Запуск Air в Docker-контейнере с подключённым каталогом проекта для автоматической перезагрузки

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

  1. 1

    Установите Air с помощью go install (требуется Go 1.25 или новее).

    go install github.com/air-verse/air@latest
  2. 2

    Добавьте каталог bin Go в PATH.

    export PATH="$PATH:$(go env GOPATH)/bin"
  3. 3

    Перейдите в каталог проекта и запустите air.

    air

Что важно знать

  • В README указано, что Air предназначен только для разработки и не связан с горячим развертыванием в production.
  • Лицензия GPL-3.0 — это лицензия с авторским левом, требующая открытого исходного кода для распространяемых производных версий.

Темы

Частые вопросы

Что такое air?
CLI-инструмент, который отслеживает файлы Go и автоматически пересобирает и перезапускает приложение во время разработки. Air — CLI-утилита для автоматической перезагрузки Go-приложений при разработке. Запустите её в корне проекта: при каждом изменении исходных файлов программа будет пересобираться и перезапускаться, так что вам не придётся останавливать и запускать её вручную. Air предназначен только для разработки и не связан с горячим развёртыванием в production.
air можно использовать бесплатно? Какая у него лицензия?
air распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
air всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в air — 27 авг. 2026 г..
Для чего можно использовать air?
Разработка Go-веб-сервера, например на gin, с перезагрузкой при каждом сохранении Запуск сборки frontend-ресурсов или шагов templ/go generate вместе с Go-приложением Запуск Air в Docker-контейнере с подключённым каталогом проекта для автоматической перезагрузки
Как установить air?
Установите Air с помощью go install (требуется Go 1.25 или новее).: go install github.com/air-verse/air@latest Добавьте каталог bin Go в PATH.: export PATH="$PATH:$(go env GOPATH)/bin" Перейдите в каталог проекта и запустите air.: air
Где скачать air?
Исходный код и инструкции по установке — на GitHub: https://github.com/air-verse/air

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

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