← 목록으로
웹 개발

다국어 블로그 만들기 — 한국어/영어 동시 지원하는 법

👁 187

왜 다국어를 지원할까?

블로그를 만들면서 "영어 버전도 제공하면 어떨까?"라는 생각이 들었습니다. 한국어로만 쓰면 한국 독자만 볼 수 있지만, 영어를 추가하면 전 세계 독자에게 다가갈 수 있으니까요.

물론 글을 두 번 쓰는 건 쉽지 않지만, DeepL 같은 AI 번역 도구를 활용하면 부담이 크게 줄어듭니다.

next-intl 라이브러리 소개

Next.js에서 다국어(i18n)를 구현하는 방법은 여러 가지가 있지만, 저는 next-intl을 선택했습니다.

선택 이유:

  • Next.js App Router와 완벽하게 호환됩니다
  • 서버 컴포넌트에서도 번역 함수를 사용할 수 있습니다
  • TypeScript 지원이 우수합니다
  • 공식 문서가 잘 되어 있습니다

구현 과정

1. 폴더 구조 설계

Next.js App Router에서 다국어를 지원하려면 URL에 언어 코드를 포함시킵니다. 예를 들어 /ko/blog, /en/blog 형태입니다. 이를 위해 app/[locale]/ 동적 경로를 사용합니다.

2. 번역 파일 관리

각 언어별 번역 메시지를 JSON 파일로 관리합니다. messages/ko.json과 messages/en.json에 UI 텍스트를 정의합니다. 네비게이션, 버튼, 안내 메시지 등 고정 텍스트는 이 파일에서 관리합니다.

3. 서버 컴포넌트에서 번역 사용

next-intl의 getTranslations 함수를 사용하면 서버 컴포넌트에서도 번역된 텍스트를 불러올 수 있습니다. 클라이언트 컴포넌트에서는 useTranslations 훅을 사용합니다.

4. 블로그 글 다국어 처리

블로그 글은 번역 파일이 아니라 데이터베이스에서 관리합니다. posts 테이블에 locale 칼럼을 추가해서 같은 slug라도 한국어 버전과 영어 버전을 별도로 저장합니다.

5. 언어 전환 기능

헤더에 언어 전환 버튼을 추가했습니다. 한국어 페이지에서 영어로 전환하면 같은 페이지의 영어 버전으로 이동합니다. 현재 URL의 locale 부분만 교체하는 간단한 로직입니다.

어려웠던 점

  • 날짜 포맷 — 한국어는 "2026년 9월 1일", 영어는 "September 1, 2026" 형태로 다르게 표시해야 합니다. Intl.DateTimeFormat API를 활용했습니다.
  • SEO 최적화 — 각 언어별로 별도의 메타태그, hreflang 태그를 설정해야 합니다.
  • 번역 품질 — DeepL로 번역한 후 직접 교정하는 과정이 필요합니다. 기술 용어는 특히 주의해야 합니다.

마치며

다국어 지원은 처음 설정할 때는 복잡하지만, 한 번 구조를 잡아놓으면 이후에는 번역 파일만 추가하면 됩니다. 글로벌 독자를 목표로 한다면 충분히 투자할 가치가 있는 기능입니다.

이것으로 블로그 만들기 시리즈의 주요 과정을 모두 다루었습니다. 다음에는 전체 과정의 총정리와 솔직한 후기를 공유할 예정입니다!

다국어(i18n) 라우팅 설계 방식 비교: 서브패스(`/ko`, `/en`) vs 서브도메인 vs 쿠키 방식

글로벌 사용자를 고려해 다국어 웹사이트를 설계할 때 가장 먼저 결정해야 할 아키텍처는 "언어 정보를 URL에 어떻게 표현할 것인가?"입니다. 구글 검색엔진 최적화(Google Search Central 다국어 가이드라인) 관점에서는 쿠키나 브라우저 설정에만 의존해 같은 URL에서 언어만 바꾸는 방식보다, 언어별로 고유한 URL 경로(`/ko/...`, `/en/...`)를 부여하는 서브패스(Sub-path) 방식을 가장 강력하게 권장합니다.

구현 방식 URL 구조 예시 검색엔진 색인(SEO) 유불리 유지보수 및 인프라 난이도
URL 서브패스 (권장) bangjang.net/ko/blog
bangjang.net/en/blog
최상 (단일 도메인 점수를 공유하면서 언어별 명확한 색인 가능) 쉬움 (`next-intl`의 `[locale]` 동적 폴더 하나로 통합 관리)
서브도메인 분리 ko.bangjang.net
en.bangjang.net
보통 (언어별 분리는 명확하나 도메인 관리 및 배포 파이프라인 이원화) 중간 (DNS 레코드 및 SSL, 배포 설정을 각각 관리해야 함)
URL 변경 없는 쿠키/스토리지 bangjang.net/blog (동일 URL) 매우 불리 (구글봇은 쿠키를 바꿔가며 크롤링하지 못해 한 가지 언어만 색인됨) 구현은 단순하나 글로벌 검색 유입을 전혀 기대할 수 없음

`next-intl`과 Next.js App Router를 연동하는 핵심 설정 코드

Next.js 15/16 App Router 환경에서 `next-intl`을 적용할 때는 ① 지원 언어 라우팅 정의(`src/i18n/routing.ts`), ② 언어별 JSON 사전 파일(`messages/ko.json`, `messages/en.json`), ③ 동적 레이아웃(`src/app/[locale]/layout.tsx`) 세 가지만 연결하면 서버 컴포넌트와 클라이언트 컴포넌트 모두에서 번역 함수를 깔끔하게 사용할 수 있습니다.

// 1. src/i18n/routing.ts - 지원 언어 및 기본 언어 정의
import { defineRouting } from "next-intl/routing";

export const routing = defineRouting({
  // 지원하는 전체 언어 코드 목록
  locales: ["ko", "en"],
  // 기본 언어 (루트 접속 시 이동할 언어)
  defaultLocale: "ko",
  // 항상 URL 경로에 언어 코드(/ko, /en)를 명시하여 SEO 모호성 제거
  localePrefix: "always",
});

// 2. 컴포넌트 내부에서 다국어 번역 텍스트 불러오기 예제
import { useTranslations } from "next-intl";

export function NewsletterBanner() {
  const t = useTranslations("home.newsletter");
  return (
    <section>
      <h2>{t("title")}</h2>
      <p>{t("description")}</p>
    </section>
  );
}

다국어 블로그 운영 시 '중복 콘텐츠(Duplicate Content)' 판정을 피하는 SEO 핵심 원칙

  • 번역본이 아직 없는 Fallback 페이지의 `canonical` 및 `noindex` 처리: 한국어로 작성된 글을 영문 경로(`/en/blog/슬러그`)에서도 에러(404) 없이 보여주도록 Fallback 기능을 넣었다면, 영문 번역이 완료되기 전까지는 해당 페이지의 ``을 반드시 **원본 한국어 URL(`/ko/blog/슬러그`)**로 지정하고 `noindex, follow`를 설정해야 합니다. 그렇지 않으면 검색엔진이 서로 다른 두 URL에 똑같은 한국어 본문이 중복 게시된 것으로 오인하여 사이트 품질 점수를 깎을 수 있습니다.
  • 완전히 번역된 글에만 `hreflang` 상호 링크 부여: 한국어 본문과 영어 번역본이 모두 준비된 페이지에는 `alternates.languages` 메타데이터를 통해 `ko`와 `en` 주소를 서로 연결해 주면, 한국 사용자에게는 한국어 페이지를, 해외 사용자에게는 영어 페이지를 구글이 정확히 매칭하여 노출해 줍니다.

댓글 (0)

첫 번째 댓글을 작성해보세요!