From f5721afa21d8634c7b739283c4625f0d495d85cb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EB=AF=BC=ED=97=8C?= Date: Tue, 16 Jun 2026 13:17:35 +0900 Subject: [PATCH] =?UTF-8?q?[fix]=20front:=20Vite=208=20=EC=97=90=EC=84=9C?= =?UTF-8?q?=20=EA=B8=88=EC=A7=80=EB=90=9C=20local=20=EB=AA=A8=EB=93=9C=20?= =?UTF-8?q?=EC=A0=9C=EA=B1=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Vite 8 은 'local' 을 모드 이름으로 허용하지 않음(.env.local 접미사 충돌) - dev 스크립트를 'vite --mode local' → 'vite' 로 변경 (.env.local 은 자동 로드) - README 환경 변수/실행 안내를 실제 동작에 맞게 갱신 Co-Authored-By: Claude Opus 4.8 (1M context) --- front/README.md | 18 +++++++++--------- front/package.json | 2 +- 2 files changed, 10 insertions(+), 10 deletions(-) diff --git a/front/README.md b/front/README.md index eadeeae..0941eb6 100644 --- a/front/README.md +++ b/front/README.md @@ -38,23 +38,23 @@ npm run dev Vite 의 mode 기능으로 환경별 env 파일을 매핑한다. 클라이언트 번들에 노출되는 변수는 반드시 `VITE_` 접두사를 붙인다. -| 파일 | mode | 용도 | git | -| --- | --- | --- | --- | -| `.env.sample` | - | 템플릿 (키 목록 공유용) | ✅ 커밋 | -| `.env.local` | `local` | 로컬 개발 | 🚫 ignore | -| `.env.dev` | `dev` | 개발 서버 | 🚫 ignore | -| `.env.prod` | `prod` | 운영 | 🚫 ignore | +| 파일 | 사용 시점 | git | +| --- | --- | --- | +| `.env.sample` | 템플릿 (키 목록 공유용) | ✅ 커밋 | +| `.env.local` | 로컬 개발 (`npm run dev`, Vite 가 자동 로드) | 🚫 ignore | +| `.env.dev` | `--mode dev` (개발 서버) | 🚫 ignore | +| `.env.prod` | `--mode prod` (운영) | 🚫 ignore | 새 환경 세팅 시 `.env.sample` 을 복사해 환경별 파일을 만들고 값을 채운다. 코드에서는 `import.meta.env.VITE_API_BASE_URL` 처럼 접근한다. -> 참고: Vite 는 mode 와 무관하게 `.env.local` 을 항상 함께 로드한다(개인 로컬 오버라이드 용도). 우선순위는 `.env.[mode]` > `.env.local` > `.env` 이므로, 각 env 파일에 **동일한 키 집합**을 유지하면 mode 파일 값이 항상 이긴다. 특정 mode 에만 있어야 할 키를 `.env.local` 에 두면 다른 mode 로 새어 들어갈 수 있으니 주의. +> 참고: Vite 8 부터 `local` 은 모드 이름으로 사용할 수 없다(`.env.local` 의 `.local` 접미사와 충돌). 그래서 로컬 개발은 별도 모드 없이 기본 `vite`(mode: `development`)로 실행하고, 로컬 값은 `.env.local` 에 둔다 — Vite 는 `.env.local` 을 **모든 모드에서 항상 자동 로드**한다(개인 로컬 오버라이드 용도). 우선순위는 `.env.[mode]` > `.env.local` > `.env` 이므로, 각 env 파일에 **동일한 키 집합**을 유지하면 mode 파일 값이 항상 이긴다. 특정 mode 에만 있어야 할 키를 `.env.local` 에 두면 다른 mode 로 새어 들어갈 수 있으니 주의. ## 실행 / 빌드 -`--mode ` 으로 위 표의 env 파일이 선택된다. +`--mode ` 으로 `.env.[name]` 파일이 선택된다(로컬은 모드 없이 `.env.local` 자동 로드). ```bash -npm run dev # 로컬 개발 서버 (mode: local → .env.local) +npm run dev # 로컬 개발 서버 (mode: development → .env.local 자동 로드) npm run dev:dev # 개발 서버를 dev 환경 변수로 실행 (mode: dev → .env.dev) npm run build # 운영 빌드 (mode: prod → .env.prod), build:prod 와 동일 diff --git a/front/package.json b/front/package.json index 00f05d0..0cb76a8 100644 --- a/front/package.json +++ b/front/package.json @@ -4,7 +4,7 @@ "version": "0.0.0", "type": "module", "scripts": { - "dev": "vite --mode local", + "dev": "vite", "dev:dev": "vite --mode dev", "build": "tsc -b && vite build --mode prod", "build:dev": "tsc -b && vite build --mode dev",