Skip to content

시작하기

들어가기 전에

Vite(프랑스어로 "빠르다(Quick)"를 의미하며, 발음은 "veet"와 비슷한 /vit/ 입니다.)는 빠르고 간결한 모던 웹 프로젝트 개발 경험에 초점을 맞춰 탄생한 빌드 도구이며, 두 가지 컨셉을 중심으로 하고 있습니다.

  • 개발 시 네이티브 ES Module을 넘어 더욱 다양한 기능을 제공합니다. 가령, Hot Module Replacement (HMR)과 같은 것들 말이죠.

  • 번들링 시, Rollup 기반의 다양한 빌드 커맨드를 사용할 수 있습니다. 이는 높은 수준으로 최적화된 정적(Static) 리소스들을 배포할 수 있게끔 하며, 미리 정의된 설정(Pre-configured)을 제공합니다.

Vite는 합리적인 기본 설정을 제공합니다. 기능 가이드에서 더 자세히 알아보세요. 프레임워크 지원이나 다른 도구와의 통합은 플러그인을 통해 가능합니다. Vite 설정하기 섹션에서는 필요에 따라 프로젝트에 Vite를 적용하는 방법을 설명합니다.

또한 Vite는 타입이 완벽하게 제공되는 플러그인 APIJavaScript API를 통해 높은 수준의 확장성을 제공합니다.

왜 Vite를 만들게 되었는지 알고 싶다면 Vite를 사용해야 하는 이유 섹션을 참고해주세요.

지원하는 브라우저

개발 단계에서, Vite는 모든 최신 JavaScript 및 CSS 기능을 지원하는 브라우저를 사용하고 있다고 가정하고 esnext를 변환 대상으로 설정해 빌드를 수행합니다. 이는 하위 호환을 생각하지 않아도 되며, Vite가 원본 소스 코드와 최대한 가깝게 모듈을 제공할 수 있도록 합니다.

프로덕션 빌드의 경우, 기본적으로 Vite는 네이티브 ES Module, 네이티브 ESM 동적 임포트, 그리고 import.meta를 지원하는 브라우저를 대상으로 빌드를 수행합니다. 레거시 브라우저는 공식 플러그인인 @vitejs/plugin-legacy를 통해 지원이 가능합니다. 이에 대한 더 자세한 내용은 프로덕션 빌드 섹션을 참고해 주세요.

온라인에서 Vite 체험해보기

StackBlitz에서 Vite를 온라인으로 체험해 볼 수 있습니다. Vite를 구성하기 위해 필요한 설정들을 브라우저에서 직접 실행하므로 로컬 환경과 매우 유사하며, 컴퓨터에 그 어떠한 것도 설치할 필요가 없습니다. vite.new/{template} 으로 이동해 사용할 프레임워크를 선택해 시작해보세요.

현재 지원하고 있는 템플릿은 다음과 같습니다:

JavaScriptTypeScript
vanillavanilla-ts
vuevue-ts
reactreact-ts
preactpreact-ts
litlit-ts
sveltesvelte-ts
solidsolid-ts
qwikqwik-ts

첫 Vite 프로젝트 만들어보기

호환성

Vite는 버전 18+ 또는 20+ 의 Node.js를 요구합니다. 다만 일부 템플릿의 경우 더 높은 버전의 Node.js를 요구할 수 있습니다.

bash
$ npm create vite@latest
bash
$ yarn create vite
bash
$ pnpm create vite
bash
$ bun create vite

이후에는 프롬프트 창에 출력된 메시지를 따라주세요.

프로젝트의 이름이나 사용하려는 템플릿을 직접 지정할 수도 있습니다. 예를 들어, Vite + Vue 프로젝트를 만들고 싶다면 다음과 같이 입력해주세요:

bash
# npm v7 이상에서는 `--` 를 반드시 붙여주세요:
$ npm create vite@latest my-vue-app -- --template vue
bash
$ yarn create vite my-vue-app --template vue
bash
$ pnpm create vite my-vue-app --template vue
bash
$ bun create vite my-vue-app --template vue

또한 create-vite에서 더욱 다양한 템플릿들에 대해 다루고 있습니다: vanilla, vanilla-ts, vue, vue-ts, react, react-ts, react-swc, react-swc-ts, preact, preact-ts, lit, lit-ts, svelte, svelte-ts, solid, solid-ts, qwik, qwik-ts.

현재 디렉터리에 프로젝트를 생성하려면 프로젝트 이름으로 .을 사용하세요.

커뮤니티 템플릿

create-vite는 인기 있는 프레임워크로 작성된 템플릿을 기반으로 프로젝트를 빠르게 시작할 수 있는 도구입니다. 이 외에도 Awesome Vite의 templates 항목에서 다양한 도구와 프레임워크를 타겟으로 하는 커뮤니티 템플릿들을 확인할 수 있습니다.

템플릿이 https://github.com/user/project와 같이 GitHub에 호스팅되어 있다면, https://github.stackblitz.com/user/project로 접속해 온라인에서 템플릿을 체험해 볼 수 있습니다. (프로젝트 URL의 github 뒷부분에 .stackblitz를 붙여주세요.)

degit을 이용하는 방법도 있습니다. 마찬가지로 프로젝트가 GitHub에 호스팅되어 있고 main을 기본 브랜치로 사용한다면, 다음과 같이 로컬에 프로젝트를 구성할 수 있습니다:

bash
npx degit user/project#main my-project
cd my-project

npm install
npm run dev

Manual Installation

프로젝트 내에서 vite CLI를 설치할 수 있습니다:

bash
$ npm install -D vite
bash
$ yarn add -D vite
bash
$ pnpm add -D vite
bash
$ bun add -D vite

그리고 다음과 같이 index.html 파일을 생성해주세요:

html
<p>Hello Vite!</p>

이후 터미널에서 vite CLI를 실행해주세요:

bash
vite

이제 http://localhost:5173에서 index.html 파일을 확인할 수 있습니다.

index.html 그리고 프로젝트의 루트

만들어진 Vite 프로젝트를 유심히 보면 index.html 파일이 public 디렉터리가 아닌 프로젝트의 루트에 위치해 있다는 것을 발견할 수 있습니다. 의도적으로 이렇게 위치시킨 것인데, 추가적인 번들링 과정 없이 index.html 파일이 앱의 진입점이 되게끔 하기 위함입니다.

Vite는 index.html 파일을 소스 코드이자 JavaScript 모듈 그래프를 구성하는 요소 중 하나로 취급하고 있습니다. 다시말해, <script type="module" src="..."> 태그를 이용해 JavaScript 소스 코드를 가져온다는 의미이며, 인라인으로 작성된 <script type="module">이나 <link href>와 같은 CSS 역시 Vite에서 취급이 가능합니다. 추가적으로, Vite는 index.html 내에 존재하는 URL에 대해 %PUBLIC_URL%과 같은 자리 표시자 없이 사용할 수 있도록 URL 베이스를 자동으로 맞춰줍니다.

Vite는 정적(Static) HTTP 서버와 비슷하게 "루트 디렉터리"라는 개념을 갖고 있습니다. 향후 <root>라는 이름으로 문서 내에서 보게 되는데, 이는 Absolute URL을 프로젝트 루트를 가리키게끔 함으로써 일반적인 정적 파일 서버와 동일하게 코드를 작성할 수 있게 됩니다. 또한 Vite는 프로젝트 루트 외부에서도 디펜던시를 가져올 수 있게끔 구현했는데, 이를 이용하면 모노리포 구성 등 다양한 작업이 가능합니다.

또한 Vite는 여러 .html 파일을 앱의 진입점으로 하는 Multi-page apps를 지원하고 있습니다.

프로젝트 루트 지정

vite은 개발 서버를 시작할 때 현재 위치해 있는 디렉터리를 프로젝트 루트로 가정하고 동작합니다. 만약 특정 디렉터리를 지정해 프로젝트 루트로써 동작하게끔 하고 싶다면, vite serve some/sub/dir 명령으로 Vite를 시작해주세요. 참고로 Vite는 프로젝트 루트 내에서 설정 파일(vite.config.js)을 확인하기에, 프로젝트 루트가 변경된다면 해당 파일도 함께 옮겨줘야 합니다.

커맨드 라인 인터페이스

vite가 설치된 프로젝트는 vite 명령을 통해 바로 Vite를 실행할 수 있습니다. (npx vite을 이용해도 되구요.) 기본적으로 Vite에서 제공하는 npm 스크립트는 아래와 같습니다.

json
{
  "scripts": {
    "dev": "vite", // 개발 서버를 실행합니다. (`vite dev` 또는 `vite serve`로도 시작이 가능합니다.)
    "build": "vite build", // 배포용 빌드 작업을 수행합니다.
    "preview": "vite preview" // 로컬에서 배포용 빌드에 대한 프리뷰 서버를 실행합니다.
  }
}

Vite CLI와 함께 --port, --open와 같은 옵션을 사용할 수 있습니다. 모든 CLI 옵션을 보고자 한다면, vite가 설치된 프로젝트 안에서 npx vite --help 명령을 실행해주세요.

좀 더 자세한 정보는 커맨드 라인 인터페이스 문서에서 다루고 있습니다.

릴리스되지 않은 Vite 사용하기

만약 아직 릴리스되지 않은 Vite를 사용하고자 한다면, 먼저 Vite 리포지토리를 로컬 컴퓨터로 클론한 뒤 이를 빌드해 사용하는 방법이 있습니다. (PNPM이 필요해요.)

bash
git clone https://github.com/vitejs/vite.git
cd vite
pnpm install
cd packages/vite
pnpm run build
pnpm link --global # 이 단계에서는 선호하는 패키지 관리자를 사용할 수 있습니다.

이후 Vite를 클론한 프로젝트 위에서 pnpm link --global vite 명령을 실행해 주세요(또는 vite를 전역적으로 링크하는 데 사용했던 패키지 관리자를 사용합니다). 이 작업 이후 개발 서버를 재시작(yarn dev)하게 되면, 클론된 Vite를 이용해 프로젝트를 진행할 수 있게 됩니다.

커뮤니티

질문이나 도움이 필요하다면, Discord 또는 GitHub Discussions에 방문해주세요.

Released under the MIT License.