환경 변수: $env/static 및 $env/dynamic
SvelteKit에서 서버와 클라이언트의 환경 변수에 안전하게 접근합니다.
환경 변수: $env/static 및 $env/dynamic은(는) CoddyKit의 무료 Sveltejs Academy 강의입니다. 이것은 4개 중 3번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Sveltejs Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Sveltejs Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
SvelteKit 환경 변수 API
SvelteKit은 환경 변수를 네 개 모듈인 static/private, static/public, dynamic/private, dynamic/public을 통해 제공합니다.
정적 비공개
빌드 시점에 읽으며 서버에서만 사용할 수 있습니다. 클라이언트 번들에서는 제거됩니다.
import { DB_URL } from "$env/static/private";정적 공개
빌드 시점에 읽고 PUBLIC_으로 시작해야 하며 클라이언트 번들에 포함됩니다.
import { PUBLIC_API_URL } from "$env/static/public";동적 비공개
서버에서 실행 시점에 읽습니다. 다시 빌드하지 않고 변경되는 구성을 적용할 때 유용합니다.
import { env } from "$env/dynamic/private";
console.log(env.SECRET);동적 공개
실행 시점에 읽으며 클라이언트와 서버 모두에서 사용할 수 있습니다. PUBLIC_으로 시작해야 합니다.
올바른 항목 선택하기
실행 시 값이 바뀌지 않으면 static을, 바뀌면 dynamic을 사용하세요(예: 기능 플래그).
비밀 정보는 절대 공개하지 않기
비밀 정보에 PUBLIC_ 접두사를 절대 붙이지 마세요. 클라이언트 번들로 유출됩니다.
환경 변수 파일
값은 .env(Git에서 무시됨)에 저장하고 .env.example은 커밋하세요.
타입 안전성
정적 변수는 자동으로 타입이 지정됩니다. 동적 변수는 Record
Vercel과 Cloudflare
각 플랫폼에는 자체 환경 변수 UI가 있습니다. 환경 간 동기화를 의도적으로 수행하세요.
테스트
해당 환경 변수 모듈에 의존한다면 테스트에서 모의 객체로 대체하세요.
빠른 확인
공개 환경 변수에 필요한 접두사는 무엇인가요?
요약
비밀 정보에는 $env/static/private를, 클라이언트에서 안전한 값에는 PUBLIC_ 접두사가 붙은 변수를 사용하세요. 필요에 따라 static과 dynamic 중 선택하세요.
자주 묻는 질문
“환경 변수: $env/static 및 $env/dynamic” 강의는 무료인가요?
네 — “환경 변수: $env/static 및 $env/dynamic” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Sveltejs Academy 강의 전체를 잠금 해제할 수 있습니다. Sveltejs Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“환경 변수: $env/static 및 $env/dynamic”에서 뭘 배우나요?
SvelteKit에서 서버와 클라이언트의 환경 변수에 안전하게 접근합니다. 브라우저에서 직접 실행하는 실습 코드로 Sveltejs Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Sveltejs Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Sveltejs Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 3번째 강의입니다.
“환경 변수: $env/static 및 $env/dynamic” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Sveltejs Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Sveltejs Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- 양식 동작의 CSRF 보호
- {#html}에서 XSS 방지
- 환경 변수: $env/static 및 $env/dynamic
- 훅을 사용한 요청 횟수 제한