0Pricing
React Academy · 강의

react-i18next 설정하기

언어 감지와 네임스페이스 분할을 포함해 i18next를 설치하고 구성합니다.

react-i18next 설정하기은(는) CoddyKit의 무료 React Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 React Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

환영합니다

이 강의에서는 언어 감지와 네임스페이스 분할을 사용해 React 앱에 다국어 지원을 추가하도록 react-i18next를 설치하고 구성합니다.

의존성 설치하기

i18next와 react-i18next를 설치하세요. 자동 로캘 감지를 위해 i18next-browser-languagedetector를, HTTP를 통한 번역 로드를 위해 i18next-http-backend를 선택적으로 추가할 수 있습니다.
npm install i18next react-i18next
npm install i18next-browser-languagedetector i18next-http-backend

i18n.js 만들기

i18next를 초기화하는 `i18n.js` 파일을 만드세요. `i18n.use(...)`를 호출해 플러그인을 추가하고, 구성과 함께 `.init({...})`을 호출하세요.
import i18n from 'i18next';
import { initReactI18next } from 'react-i18next';
import LanguageDetector from 'i18next-browser-languagedetector';

i18n
  .use(LanguageDetector)
  .use(initReactI18next)
  .init({
    fallbackLng: 'en',
    resources: { en: { translation: {} }, tr: { translation: {} } },
    interpolation: { escapeValue: false },
  });

export default i18n;

main.jsx에서 i18n 가져오기

앱을 렌더링하기 전에 i18n 초기화 파일을 가져오세요 BEFORE. 이렇게 하면 어떤 컴포넌트든 useTranslation을 호출하기 전에 i18n이 준비됩니다.
import './i18n'; // must be before App
import { StrictMode } from 'react';
import { createRoot } from 'react-dom/client';
import App from './App';

createRoot(document.getElementById('root')).render(
  <StrictMode><App /></StrictMode>
);

네임스페이스

네임스페이스는 번역을 논리적인 그룹(예: ‘공통’, ‘인증’, ‘대시보드’)으로 나눕니다. 각 네임스페이스는 별도의 JSON 파일이며, 초기 번들 크기를 줄이기 위해 필요할 때 로드됩니다.
resources: {
  en: {
    common: { save: 'Save', cancel: 'Cancel' },
    auth: { login: 'Log in', logout: 'Log out' },
  }
}

언어 감지

LanguageDetector 플러그인은 브라우저(navigator.language), localStorage 또는 URL 쿼리 문자열에서 사용자가 선호하는 언어를 읽습니다. 최초 로드 시 활성 언어를 자동으로 설정합니다.

공개 폴더에서 번역 로드하기

번역을 `public/locales/{lang}/{ns}.json`에 JSON 파일로 저장하세요. 백엔드 플러그인이 실행 시 해당 파일을 로드하도록 구성하면 새 언어를 추가할 때 코드를 변경할 필요가 없습니다.
import Backend from 'i18next-http-backend';

i18n.use(Backend).init({
  backend: {
    loadPath: '/locales/{{lng}}/{{ns}}.json',
  },
});

I18nextProvider(선택 사항)

I18nextProvider는 컨텍스트를 통해 i18n 인스턴스를 제공하도록 앱을 래핑합니다. react-i18next v11 이상과 initReactI18next 플러그인을 사용하면 선택 사항입니다. 훅이 전역 i18n 인스턴스를 직접 읽기 때문입니다.

컴포넌트에서 초기화 확인하기

i18next는 번역을 비동기적으로 로드합니다. 번역 키가 표시되는 것을 방지하려면 useTranslation의 `ready` 속성을 사용하거나 렌더링하기 전에 `i18n.isInitialized`를 확인하세요.
const { t, ready } = useTranslation();
if (!ready) return null;

DevTools와 누락된 키 처리

개발 환경에서 `saveMissing: true`를 설정하면 누락된 번역 키가 콘솔에 로그로 기록됩니다. 이를 통해 번역되지 않은 문자열을 빠르게 찾을 수 있습니다.
i18n.init({ saveMissing: true,
  missingKeyHandler: (lng, ns, key) => console.warn('Missing:', key) });

빠른 확인

React 앱을 렌더링하기 전에 i18n 초기화 파일을 가져와야 하는 이유는 무엇인가요?

복습

i18next와 react-i18next를 설치하고, 플러그인과 init 구성을 포함한 i18n.js를 만든 다음, 렌더링 전에 가져오고 번역을 네임스페이스로 구성하세요. http-backend를 사용하면 실행 시 번역 파일을 로드할 수 있습니다.

다음 학습

다음 학습: **useTranslation Hook 사용하기** — 하드코딩된 문자열을 t() 호출로 바꾸고 JSON 번역 파일을 구성합니다.

자주 묻는 질문

“react-i18next 설정하기” 강의는 무료인가요?

네 — “react-i18next 설정하기” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 React Academy 강의 전체를 잠금 해제할 수 있습니다. React Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“react-i18next 설정하기”에서 뭘 배우나요?

언어 감지와 네임스페이스 분할을 포함해 i18next를 설치하고 구성합니다. 브라우저에서 직접 실행하는 실습 코드로 React Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

React Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 React Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“react-i18next 설정하기” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 React Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 React Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. react-i18next 설정하기
  2. useTranslation 훅 사용하기
  3. 복수형 처리와 보간
  4. 언어 전환기와 번역 지연 로딩
← React Academy(으)로 돌아가기