vue-i18n 설정과 메시지 파일
createI18n(), 로케일 JSON 파일, 메시지 구문 {name}, 중첩 키와 대체 로케일을 익힙니다.
vue-i18n 설정과 메시지 파일은(는) CoddyKit의 무료 Vue Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Vue Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
i18n이란 무엇인가요?
국제화(i18n)는 앱이 여러 언어로 텍스트를 표시할 수 있도록 만드는 것입니다. Vue I18n은 Vue 앱을 번역하기 위한 공식 스타일의 라이브러리입니다.
영어 문자열을 코드에 직접 작성하는 대신, 활성 언어에 해당하는 값으로 해석되는 키를 조회합니다.
Vue I18n 설치하기
패키지를 추가합니다. Vue 3에서는 컴포지션 API를 기반으로 하는 버전 9 이상을 사용합니다.
// terminal
// npm install vue-i18n메시지 파일
번역은 로캘마다 하나씩 있는 메시지 객체에 저장됩니다. 키는 번역된 문자열에 연결됩니다. 영어부터 시작하십시오.
const en = {
greeting: "Hello",
nav: {
home: "Home",
about: "About",
},
}터키어 로캘 추가하기
모든 언어에서 모든 키가 존재하도록 각 로캘은 동일한 키 구조를 반영해야 합니다.
const tr = {
greeting: "Merhaba",
nav: {
home: "Ana Sayfa",
about: "Hakkinda",
},
}i18n 인스턴스 만들기
createI18n이 인스턴스를 만듭니다. locale(활성 언어), fallbackLocale(키가 없을 때 사용되는 언어), messages 맵을 설정합니다.
import { createI18n } from "vue-i18n"
const i18n = createI18n({
legacy: false,
locale: "en",
fallbackLocale: "en",
messages: { en, tr },
})legacy: false를 사용하는 이유
legacy: false를 설정하면 최신 Vue 3 앱에서 사용하는 컴포지션 API 모드가 활성화됩니다. 다음 레슨에서 배울 useI18n 컴포저블도 사용할 수 있게 됩니다.
const i18n = createI18n({
legacy: false, // Composition API mode
locale: "en",
messages: { en, tr },
})앱에 등록하기
app.use(i18n)으로 인스턴스를 플러그인으로 설치합니다. 그러면 컴포넌트 트리 전체에서 번역 도우미를 사용할 수 있습니다.
import { createApp } from "vue"
import App from "./App.vue"
const app = createApp(App)
app.use(i18n)
app.mount("#app")템플릿에서 $t 사용하기
설치가 끝나면 모든 템플릿에서 $t(key)를 호출하여 활성 로캘의 번역을 조회할 수 있습니다.
<template>
<h1>{{ $t("greeting") }}</h1>
<a>{{ $t("nav.home") }}</a>
</template>fallbackLocale의 작동 방식
활성 로캘에 키가 없으면 Vue I18n은 원시 키를 표시하는 대신 fallbackLocale로 대체합니다. 번역이 진행 중일 때도 UI를 자연스럽게 유지할 수 있습니다.
// tr is missing "tagline" -> falls back to en
// {{ $t("tagline") }} renders the English text자리 표시자를 사용한 보간
메시지에는 중괄호로 묶은 이름 있는 자리 표시자를 포함할 수 있습니다. 두 번째 인수로 값을 전달하여 내용을 채웁니다.
const en = {
welcome: "Welcome, {name}!",
}
// template:
// {{ $t("welcome", { name: "Ada" }) }}
// => "Welcome, Ada!"메시지 파일 구성하기
실제 앱에서는 각 로캘을 별도의 파일(en.json, tr.json)에 저장하고 가져옵니다. 이렇게 하면 번역을 관리하기 쉽고 번역가가 독립적으로 작업할 수 있습니다.
// locales/en.json, locales/tr.json
import en from "./locales/en.json"
import tr from "./locales/tr.json"
createI18n({ locale: "en", messages: { en, tr } })빠른 확인
Vue I18n 설정에 대한 이해도를 확인하십시오.
복습
Vue I18n을 설정하는 방법을 배웠습니다.
- i18n은 키를 조회하여 여러 언어로 텍스트를 표시하는 것을 의미합니다.
- 각 로캘마다 동일한 키 구조의 메시지 객체를 정의합니다.
createI18n은locale,fallbackLocale,messages를 받습니다. 컴포지션 모드에는legacy: false를 사용합니다.app.use(i18n)으로 설치하고 템플릿에서는$t(key)로 번역합니다.{name}과 같은 자리 표시자는 두 번째 인수를 통해 채웁니다.
자주 묻는 질문
“vue-i18n 설정과 메시지 파일” 강의는 무료인가요?
네 — “vue-i18n 설정과 메시지 파일” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Vue Academy 강의 전체를 잠금 해제할 수 있습니다. Vue Academy 강의에는 총 4개의 강의가 포함되어 있습니다.
“vue-i18n 설정과 메시지 파일”에서 뭘 배우나요?
createI18n(), 로케일 JSON 파일, 메시지 구문 {name}, 중첩 키와 대체 로케일을 익힙니다. 브라우저에서 직접 실행하는 실습 코드로 Vue Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.
Vue Academy을(를) 시작하는 데 경험이 필요한가요?
사전 경험은 필요하지 않습니다. CoddyKit의 Vue Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.
“vue-i18n 설정과 메시지 파일” 강의는 얼마나 걸리나요?
대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.
이 Vue Academy 강의에서 코드를 작성하고 실행할 수 있나요?
네. 모든 Vue Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.
이 강의의 모든 강의
- vue-i18n 설정과 메시지 파일
- useI18n 컴포저블과 t() 함수
- 복수형 처리와 연결된 메시지
- 숫자, 날짜와 통화 형식 지정