air-verse/air

어떤 프로젝트인가요?

핵심 기능

• 01파일이 변경될 때 Go 앱을 자동으로 다시 빌드하고 재시작
• 02`.air.toml` 또는 CLI 플래그로 빌드 및 실행 명령 설정
• 03하위 디렉터리를 제외하고 새로 생성된 디렉터리 감시
• 04감시 규칙에 따라 에셋 빌드나 코드 생성용 사용자 지정 명령 실행
• 05빌드가 끝날 때마다 브라우저를 새로고침하는 선택적 프록시
• 06빌드 및 실행 전에 `.env` 파일 불러오기

활용 사례

• gin으로 만든 웹 서버 같은 Go 서버를 개발하면서 저장할 때마다 다시 로드
• Go 앱과 함께 프런트엔드 에셋 빌드나 templ/go generate 단계 실행
• 프로젝트를 마운트해 라이브 리로드가 가능하도록 Docker 컨테이너 안에서 Air 실행

빠른 시작

1. 1

   go install을 사용해 Air를 설치합니다(Go 1.25 이상 필요).

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

   Go의 bin 디렉터리를 PATH에 추가합니다.

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

   프로젝트 디렉터리로 이동해 air를 실행합니다.

   air

사용 전 알아둘 점

• !README에 따르면 Air는 개발 전용이며 프로덕션 핫 디플로이와는 관련이 없습니다.
• !GPL-3.0 라이선스가 적용됩니다. 카피레프트 라이선스이므로 파생물을 배포할 때는 오픈소스로 공개해야 합니다.

토픽

자주 묻는 질문

air은(는) 무엇인가요?

Go 소스 파일을 감시해 개발 중 앱을 자동으로 다시 빌드하고 재시작하는 명령줄 도구입니다. Air는 Go 애플리케이션 개발을 위한 라이브 리로드 명령줄 도구입니다. 프로젝트 루트에서 실행하면 소스 파일이 변경될 때마다 프로그램을 다시 빌드하고 재시작하므로, 프로세스를 직접 중지했다가 시작하지 않고 계속 코드를 수정할 수 있습니다. 개발용으로만 제공되며 프로덕션 환경의 핫 배포와는 무관합니다.

air은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

air은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

air은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. air의 마지막 커밋은 2026년 8월 27일입니다.

air은(는) 어디에 사용할 수 있나요?

gin으로 만든 웹 서버 같은 Go 서버를 개발하면서 저장할 때마다 다시 로드 Go 앱과 함께 프런트엔드 에셋 빌드나 templ/go generate 단계 실행 프로젝트를 마운트해 라이브 리로드가 가능하도록 Docker 컨테이너 안에서 Air 실행

air는 어떻게 설치하나요?

go install을 사용해 Air를 설치합니다(Go 1.25 이상 필요).: go install github.com/air-verse/air@latest Go의 bin 디렉터리를 PATH에 추가합니다.: export PATH="$PATH:$(go env GOPATH)/bin" 프로젝트 디렉터리로 이동해 air를 실행합니다.: air

air은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/air-verse/air