프론트엔드 · 기술

Vite

Vite는 프론트엔드 개발 서버와 프로덕션 번들을 제공하는 빌드 도구입니다.

적용 범위: Vite의 개념·동작을 확인해야 하는 공개 웹 환경문맥: 바이브 코딩
출처: Vite
출처 확인일: 2026-07-27
최종 검토: 2026-07-27
정정 이력: 2026-07-29 이후 기록 없음

오류·수정 제보

정상 동작 조건

요약

Vite 문제를 확인할 때는 개발 서버와 vite build 결과를 분리하고, 현재 작업 디렉터리·기본 경로·환경 변수 접두사를 함께 확인해야 합니다.

확인 절차

Vite는 개발 서버와 프로덕션 번들을 별도 명령으로 제공합니다. 개발 서버에서 동작한 결과만으로 배포 산출물의 경로, 정적 자산 주소와 환경 변수 값이 올바르다고 판단하지 않습니다.

배포 전 확인

실제 실행한 명령과 현재 작업 디렉터리를 기록합니다.
vite build 결과 디렉터리와 배포 서비스의 산출물 경로를 비교합니다.
브라우저에 노출되어도 되는 값과 서버 전용 비밀값을 분리합니다.
하위 경로에 배포한다면 base 설정과 실제 요청 주소를 함께 확인합니다.

배포 후에만 발생하는 오류는 빌드 산출물 (새 창에서 열림)과 환경 변수 (새 창에서 열림)의 적용 범위를 분리해 확인합니다.

관련 오류·증상

import.meta.env.VITE_* is undefined

Vite 애플리케이션에서 import.meta.env의 환경 변수가 undefined로 보일 때 변수 이름·모드·빌드 시점을 확인합니다.

Failed to resolve import

Failed to resolve import 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Internal server error: Failed to resolve import

Internal server error: Failed to resolve import 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

Vite mode에 맞는 환경 변수 파일이 로드되지 않음

Vite 개발·배포 명령의 mode와 환경 변수 파일이 달라 예상한 값이 주입되지 않는지 확인하는 문서입니다.

Pre-transform error

Pre-transform error 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

The requested module does not provide an export named

The requested module does not provide an export named 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

The service was stopped

The service was stopped 오류 원문이 표시될 때 의미와 확인 절차를 정리한 문서입니다.

참고 자료

Vite · 공식 자료 · 확인 범위: dev-server, production-build, build-configuration · 확인일: 2026-07-27