์ž‘๊ฐ€:
    ์ƒ์„ฑ:2026-09-16๋งˆ์ง€๋ง‰ ์—…๋ฐ์ดํŠธ:2026-10-08

    ์˜ฌ๋ฐ”๋ฅธ React i18n ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์„ ํƒํ•˜๋Š” ๋ฐฉ๋ฒ•

    youtube.com

    React๋Š” ๊ธฐ๋ณธ i18n ํ”„๋ฆฌ๋ฏธํ‹ฐ๋ธŒ๋ฅผ ์ œ๊ณตํ•˜์ง€ ์•Š์Šต๋‹ˆ๋‹ค. ์ฒซ๋‚  ์„ ํƒํ•œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ๋ฒˆ์—ญ ์ €์žฅ ๋ฐฉ์‹, ๋ฒˆ๋“ค ํฌํ•จ ๋ฐฉ์‹, ํ–ฅํ›„ ์ˆ˜๋…„๊ฐ„ ๊ฐœ๋ฐœ์ž๊ฐ€ ์ง์ ‘ ๊ฐ๋‹นํ•ด์•ผ ํ•  ์ž‘์—…์˜ ์–‘์„ ๊ฒฐ์ •ํ•ฉ๋‹ˆ๋‹ค. ๋Œ€๋ถ€๋ถ„์˜ ํŒ€์€ ์ธ๊ธฐ๋„๋ฅผ ๊ธฐ์ค€์œผ๋กœ ์„ ํƒํ–ˆ๋‹ค๊ฐ€, ํ‚ค๊ฐ€ 2,000๊ฐœ์— ๋„๋‹ฌํ–ˆ์„ ๋•Œ ๋น„๋กœ์†Œ ํŠธ๋ ˆ์ด๋“œ์˜คํ”„๋ฅผ ๊นจ๋‹ซ๊ฒŒ ๋ฉ๋‹ˆ๋‹ค.

    ์ด ๊ฐ€์ด๋“œ๋Š” ๋ฐ˜๋Œ€๋กœ ์ ‘๊ทผํ•ฉ๋‹ˆ๋‹ค. ๋จผ์ € ํ”„๋กœ์ ํŠธ์— ๋Œ€ํ•œ ๋ช‡ ๊ฐ€์ง€ ์งˆ๋ฌธ์— ๋‹ตํ•œ ๋‹ค์Œ, ํ•ด๋‹น ๋‹ต๋ณ€์— ๋งž๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ๋งคํ•‘ํ•ฉ๋‹ˆ๋‹ค. ์ด ๊ธ€์€ ์ˆœ์ˆ˜ React(Vite, React Router, TanStack Start)์— ์ดˆ์ ์„ ๋งž์ถฅ๋‹ˆ๋‹ค. Next.js๋Š” ๊ณ ์œ ํ•œ ์ œ์•ฝ ์‚ฌํ•ญ์ด ์žˆ์œผ๋ฉฐ, ์ด๋Š” Next.js ๋น„๊ต์—์„œ ๋‹ค๋ฃน๋‹ˆ๋‹ค.

    ๋ชฉ์ฐจ

    ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ๋น„๊ตํ•˜๊ธฐ ์ „์— ๋‹ตํ•ด์•ผ ํ•  6๊ฐ€์ง€ ์งˆ๋ฌธ

    ์ž์‹ ์—๊ฒŒ ์–ด๋–ค ๊ธฐ์ค€์ด ์ค‘์š”ํ•œ์ง€ ๋ชจ๋ฅธ๋‹ค๋ฉด ๊ธฐ๋Šฅ ๋น„๊ตํ‘œ๋Š” ๋ฌด์šฉ์ง€๋ฌผ์ž…๋‹ˆ๋‹ค. ๋‹ค์Œ ํ•ญ๋ชฉ์„ ๋จผ์ € ๊ฒ€ํ† ํ•˜์„ธ์š”.

    1. ์•ฑ์ด ์–ด๋–ป๊ฒŒ ๋ Œ๋”๋ง๋˜๋‚˜์š”? SPA ์ „์šฉ, hydration์„ ํฌํ•จํ•œ SSR, ๋˜๋Š” React Server Components(RSC). Context ๊ธฐ๋ฐ˜ hook์€ SPA ์–ด๋””์„œ๋‚˜ ์ž‘๋™ํ•ฉ๋‹ˆ๋‹ค. RSC์—์„œ๋Š” hook์„ ์‚ฌ์šฉํ•˜๋ฉด ํ…์ŠคํŠธ๋ฅผ ๋ Œ๋”๋งํ•˜๋Š” ๋ชจ๋“  ์ปดํฌ๋„ŒํŠธ์— "use client"๊ฐ€ ๊ฐ•์ œ๋˜๋ฏ€๋กœ ์„œ๋ฒ„ ์‚ฌ์ด๋“œ API๋„ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.
    2. ๋ˆ„๊ฐ€ ๋ฒˆ์—ญ์„ ์ž‘์„ฑํ•˜๋‚˜์š”? ๊ฐœ๋ฐœ์ž, TMS๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์‚ฌ๋‚ด ํŒ€, ICU ํŒŒ์ผ์„ ์ „๋‹ฌํ•˜๋Š” ์—์ด์ „์‹œ, ๋˜๋Š” AI ํŒŒ์ดํ”„๋ผ์ธ. ์ด๋Š” ์–ด๋–ค API ์„ธ๋ถ€์‚ฌํ•ญ๋ณด๋‹ค ์นดํƒˆ๋กœ๊ทธ ํ˜•์‹์„ ์ง์ ‘์ ์œผ๋กœ ๊ฒฐ์ •ํ•ฉ๋‹ˆ๋‹ค.
    3. ๋กœ์ผ€์ผ๊ณผ ํŽ˜์ด์ง€ ์ˆ˜๋Š” ์–ผ๋งˆ๋‚˜ ๋˜๋‚˜์š”? 2๊ฐœ ๋กœ์ผ€์ผ๊ณผ 5๊ฐœ ํŽ˜์ด์ง€๋ผ๋ฉด ๋ชจ๋“  ๋ฒˆ์—ญ์„ ํ•œ ๋ฒˆ์— ์ „์†กํ•ด๋„ ๊ดœ์ฐฎ์Šต๋‹ˆ๋‹ค. ํ•˜์ง€๋งŒ 10๊ฐœ ๋กœ์ผ€์ผ๊ณผ 50๊ฐœ ๋ผ์šฐํŠธ๋ผ๋ฉด ๋ถˆ๊ฐ€๋Šฅํ•˜๋ฉฐ, ๋กœ๋”ฉ ์ „๋žต์ด ์ฃผ์š” ๋น„์šฉ ์š”์ธ์ด ๋ฉ๋‹ˆ๋‹ค.
    4. ํ‚ค์— ๋Œ€ํ•œ ํƒ€์ž…์ด ํ•„์š”ํ•œ๊ฐ€์š”? t("checkout.totl")๊ณผ ๊ฐ™์€ ์˜คํƒ€๋Š” ํƒ€์ž…์„ ์ง์ ‘ ์—ฐ๊ฒฐํ•˜์ง€ ์•Š๋Š” ํ•œ ๋ชจ๋“  ํ‚ค ๊ธฐ๋ฐ˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์—์„œ ๊ทธ๋Œ€๋กœ ์ปดํŒŒ์ผ๋ฉ๋‹ˆ๋‹ค. ์ด๋ฅผ ๊ฐ์ˆ˜ํ•  ์ˆ˜ ์žˆ๋Š”์ง€ ๊ฒฐ์ •ํ•˜์„ธ์š”.
    5. ๋ฌธ์ž์—ด์— ๋ฌด์—‡์ด ํฌํ•จ๋˜๋‚˜์š”? ์ผ๋ฐ˜ ํ…์ŠคํŠธ, ๋ณต์ˆ˜ํ˜•(plurals), ๋˜๋Š” ์ค‘๊ฐ„์— <Link>๊ฐ€ ํฌํ•จ๋œ ๋ฌธ์žฅ. ๋ฆฌ์น˜ ์ฝ˜ํ…์ธ (rich content)๋Š” ๋Œ€๋ถ€๋ถ„์˜ API๊ฐ€ ๋‹ค๋ฃจ๊ธฐ ๊นŒ๋‹ค๋กœ์›Œ์ง€๋Š” ์˜์—ญ์ž…๋‹ˆ๋‹ค.
    6. ํ”„๋กœ์ ํŠธ ์ˆ˜๋ช…์ด ์–ผ๋งˆ๋‚˜ ๋˜๋‚˜์š”? 3๊ฐœ์›”์งœ๋ฆฌ ํ”„๋กœํ† ํƒ€์ž…๊ณผ 5๋…„ ๋™์•ˆ ์œ ์ง€๋  ํ”„๋กœ๋•์…˜ ์ œํ’ˆ์€ ํ•„์š”ํ•œ ๋นŒ๋“œ ๋„๊ตฌ์˜ ๊ทœ๋ชจ๊ฐ€ ๋‹ค๋ฆ…๋‹ˆ๋‹ค.

    ๋‹ต๋ณ€์„ ์ ์–ด๋‘์„ธ์š”. ์•„๋ž˜์˜ ๋ชจ๋“  ๋‚ด์šฉ์€ ์ด ๋‹ต๋ณ€๋“ค์„ ๊ธฐ์ค€์œผ๋กœ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.

    ํ•œ๋ˆˆ์— ๋ณด๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ํ™˜๊ฒฝ

    ์ง€๋‚œ 15๋…„๊ฐ„์˜ JavaScript i18n ์—ญ์‚ฌ๋Š” 4๊ฐœ์˜ ์•„ํ‚คํ…์ฒ˜ ํ๋ฆ„์œผ๋กœ ๋‚˜๋‰˜๋ฉฐ, ๋น„๊ต ๋Œ€์ƒ React ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋“ค๋„ ์„œ๋กœ ๋‹ค๋ฅธ ์„ธ๋Œ€์— ์†ํ•ด ์žˆ์Šต๋‹ˆ๋‹ค.

    History of JavaScript i18n libraries

    ๋ฉ”๋ชจ๋ฆฌ์— ๋กœ๋“œ๋˜๋Š” JSON ์นดํƒˆ๋กœ๊ทธ, ๋Ÿฐํƒ€์ž„์— ์กฐํšŒ๋˜๋Š” t("a.b"), ๋ธŒ๋ผ์šฐ์ €์—์„œ ํŒŒ์‹ฑ๋˜๋Š” ICU ๋˜๋Š” ์ปค์Šคํ…€ ๋ฌธ๋ฒ•. ๊ฐ€์žฅ ํฐ ์ƒํƒœ๊ณ„๋ฅผ ๊ฐ–์ถ”๊ณ  ์žˆ์ง€๋งŒ ๋Ÿฐํƒ€์ž„์ด ๊ฐ€์žฅ ๋ฌด๊ฒ๊ณ , ํƒ€์ž… ์ง€์›์€ ์„ ํƒ ์‚ฌํ•ญ์ž…๋‹ˆ๋‹ค.

    ๋นŒ๋“œ ์‹œ ๋ฉ”์‹œ์ง€๋ฅผ ์ถ”์ถœํ•˜์—ฌ ์ปดํŒฉํŠธํ•œ ์นดํƒˆ๋กœ๊ทธ๋กœ ์ปดํŒŒ์ผํ•˜๊ณ  ์ธ์ž๋ฅผ ํƒ€์ž…ํ™”ํ•ฉ๋‹ˆ๋‹ค. ๋” ์ž‘์€ ๋ฒˆ๋“ค์„ ์–ป๋Š” ๋Œ€์‹  ์ถ”๊ฐ€ ๋นŒ๋“œ ๋‹จ๊ณ„(extract, compile)๊ฐ€ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค.

    SSR ๋ฐ Server Components๋ฅผ ์ค‘์‹ฌ์œผ๋กœ ์„ค๊ณ„๋˜์—ˆ์Šต๋‹ˆ๋‹ค. ์„œ๋ฒ„์—์„œ ๋ Œ๋”๋งํ•˜๊ณ  ํด๋ผ์ด์–ธํŠธ๊ฐ€ ํ•„์š”ํ•œ ๋ถ€๋ถ„๋งŒ hydrateํ•ฉ๋‹ˆ๋‹ค. ์—ฌ์ „ํžˆ ํ‚ค ๊ธฐ๋ฐ˜ ๋ฐ ์ค‘์•™์ง‘์ค‘์‹ ๋ฐฉ์‹์„ ๋”ฐ๋ฆ…๋‹ˆ๋‹ค.

    ์ฝ˜ํ…์ธ ๊ฐ€ ํŠธ๋ฆฌ ์‰์ดํ‚น ๊ฐ€๋Šฅํ•œ ํ•จ์ˆ˜๋‚˜ ์ปดํฌ๋„ŒํŠธ๋ณ„ ๋”•์…”๋„ˆ๋ฆฌ๋กœ ์ปดํŒŒ์ผ๋ฉ๋‹ˆ๋‹ค. ํƒ€์ž…์ด ์ž๋™ ์ƒ์„ฑ๋˜๊ณ , ๋ˆ„๋ฝ๋œ ๋ฒˆ์—ญ์ด ์žˆ์œผ๋ฉด ๋นŒ๋“œ๊ฐ€ ์‹คํŒจํ•˜๋ฉฐ, CLI์—์„œ AI ๋ฒˆ์—ญ์„ ์‹คํ–‰ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    JavaScript i18n์˜ ์—ญ์‚ฌ์—์„œ ๊ฐ ํ๋ฆ„์ด ์ด์ „ ์„ธ๋Œ€์˜ ๋ฌธ์ œ๋ฅผ ์–ด๋–ป๊ฒŒ ํ•ด๊ฒฐํ–ˆ๋Š”์ง€ ์ž์„ธํžˆ ํ™•์ธํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    ๊ฐ€์žฅ ์ค‘์š”ํ•œ ๊ฒฐ์ •: ์ฝ˜ํ…์ธ ์˜ ์œ„์น˜์™€ ๋กœ๋”ฉ ์‹œ์ 

    ๋ชจ๋“  React i18n ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” store, provider, hook์ด๋ผ๋Š” ๋™์ผํ•œ ๊ตฌ์กฐ๋ฅผ ๊ฐ€์ง‘๋‹ˆ๋‹ค. provider๊ฐ€ ๋ฐ›๋Š” ๋ฐ์ดํ„ฐ๋Š” ๋ชจ๋‘ ํด๋ผ์ด์–ธํŠธ ๋ฒˆ๋“ค์ด๋‚˜ hydration ํŽ˜์ด๋กœ๋“œ์— ํฌํ•จ๋ฉ๋‹ˆ๋‹ค. ๋”ฐ๋ผ์„œ ๋‘ ๊ฐ€์ง€ ๊ตฌ์กฐ์  ์„ ํƒ์ด ํ•ต์‹ฌ์ž…๋‹ˆ๋‹ค:

    • ์ค‘์•™์ง‘์ค‘์‹ vs ๋ฒ”์œ„ ์ œํ•œ(scoped) ์ฝ˜ํ…์ธ . ์•ฑ ์ „์ฒด๋ฅผ ์œ„ํ•œ ํ•˜๋‚˜์˜ en.json์„ ๋‘˜ ๊ฒƒ์ธ์ง€, ์ปดํฌ๋„ŒํŠธ๋ณ„(๋˜๋Š” ๋„ค์ž„์ŠคํŽ˜์ด์Šค๋ณ„) ์„ ์–ธ์„ ๋‘˜ ๊ฒƒ์ธ์ง€.
    • ์ •์  import vs ๋™์  import. ์‹œ์ž‘ ์‹œ ๋ชจ๋“  ๊ฒƒ์„ ๋ฒˆ๋“ค๋งํ•  ๊ฒƒ์ธ์ง€, ํ™œ์„ฑ ๋กœ์ผ€์ผ๊ณผ ๋ผ์šฐํŠธ๋ฅผ ํ•„์š”์— ๋”ฐ๋ผ ์˜จ๋””๋งจ๋“œ๋กœ ๊ฐ€์ ธ์˜ฌ ๊ฒƒ์ธ์ง€.

    ์•„๋ž˜ ๊ทธ๋ž˜ํ”„๋Š” ํŽ˜์ด์ง€๋‹น ์•ฝ 30KB์˜ ํ…์ŠคํŠธ๊ฐ€ ํฌํ•จ๋œ 1~10๊ฐœ ํŽ˜์ด์ง€์™€ 1~10๊ฐœ ๋กœ์ผ€์ผ๋กœ ๋ฒˆ์—ญ๋œ ๊ฐ€์ƒ ์•ฑ์˜ ํŽ˜์ด๋กœ๋“œ๋ฅผ ์ถ”์ •ํ•œ ๊ฒƒ์ž…๋‹ˆ๋‹ค.

    Theoretical content leakage by architecture

    ์ •์  import๋ฅผ ์‚ฌ์šฉํ•˜๋Š” ์ค‘์•™์ง‘์ค‘์‹ ์ฝ˜ํ…์ธ ๋Š” ๋‘ ์ถ• ๋ชจ๋‘์—์„œ ์ฆ๊ฐ€ํ•ฉ๋‹ˆ๋‹ค. 10๊ฐœ ํŽ˜์ด์ง€ x 10๊ฐœ ๋กœ์ผ€์ผ์€ ๋ชจ๋“  ํŽ˜์ด์ง€์—์„œ 300KB์˜ ํ…์ŠคํŠธ๋ฅผ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค. ๋™์  import๋Š” ๋กœ์ผ€์ผ ์ถ•์˜ ๋ถ€๋‹ด์„ ์—†์•ฑ๋‹ˆ๋‹ค. ๋ฒ”์œ„ ์ œํ•œ(scoping)์€ ํŽ˜์ด์ง€ ์ถ•์˜ ๋ถ€๋‹ด์„ ์—†์•ฑ๋‹ˆ๋‹ค. ์˜ค์ง ๋‘ ๊ฐ€์ง€๋ฅผ ์กฐํ•ฉํ•ด์•ผ๋งŒ ์ผ์ •ํ•œ ํฌ๊ธฐ๋ฅผ ์œ ์ง€ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    ์ด๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ž์ฒด์˜ ํŠน์„ฑ์ด ์•„๋‹ˆ๋ผ ๊ด€๋ฆฌ ๊ทœ์œจ์˜ ๋ฌธ์ œ์ž…๋‹ˆ๋‹ค. react-i18next๋Š” ๋„ค์ž„์ŠคํŽ˜์ด์Šค์™€ lazy ๋ฐฑ์—”๋“œ๋กœ ๋ฒ”์œ„๋ฅผ ๋‚˜๋ˆŒ ์ˆ˜ ์žˆ๊ณ , use-intl์€ ๋ผ์šฐํŠธ๋ณ„๋กœ ๋ถ„ํ• ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ํ•˜์ง€๋งŒ ์ด๋ฅผ ๊ฐ•์ œํ•˜๋Š” ์žฅ์น˜๊ฐ€ ์—†๊ธฐ ๋•Œ๋ฌธ์—, ๊ณต์œ  ์ปดํฌ๋„ŒํŠธ์ธ <Button>์ด t("common:cta")๋ฅผ ์ฐธ์กฐํ•˜๋Š” ์ˆœ๊ฐ„ common ๋„ค์ž„์ŠคํŽ˜์ด์Šค๊ฐ€ ๋ชจ๋“  ๋ผ์šฐํŠธ์˜ ์˜์กด์„ฑ์ด ๋˜์–ด ๋ฒ„๋ฆฝ๋‹ˆ๋‹ค. ๋ฒค์น˜๋งˆํฌ์—์„œ๋Š” ์ด๋ฅผ "๋‹ค๋ฅธ ๋ผ์šฐํŠธ๋กœ๋ถ€ํ„ฐ์˜ ๋ˆ„์ˆ˜" ๋ฐ "๋‹ค๋ฅธ ๋กœ์ผ€์ผ๋กœ๋ถ€ํ„ฐ์˜ ๋ˆ„์ˆ˜"๋กœ ์ธก์ •ํ•˜๋ฉฐ, ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ๊ฐ„์˜ ๊ฒฉ์ฐจ ๋Œ€๋ถ€๋ถ„์ด ์—ฌ๊ธฐ์„œ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค.

    3๋ฒˆ ์งˆ๋ฌธ์— "๋งŽ์€ ๋กœ์ผ€์ผ, ๋งŽ์€ ํŽ˜์ด์ง€"๋ผ๊ณ  ๋‹ตํ–ˆ๋‹ค๋ฉด ์–ด๋–ค API ์„ ํ˜ธ๋„๋ณด๋‹ค ์ด ์„น์…˜์„ ์ค‘์š”ํ•˜๊ฒŒ ๊ณ ๋ คํ•˜์„ธ์š”. ์ปดํฌ๋„ŒํŠธ๋ณ„ vs ์ค‘์•™์ง‘์ค‘์‹ i18n ํฌ์ŠคํŠธ์—์„œ ๋™์ผํ•œ ์„ ํƒ์˜ ์œ ์ง€๋ณด์ˆ˜ ์ธก๋ฉด์„ ๋” ๊นŠ์ด ๋‹ค๋ฃน๋‹ˆ๋‹ค.

    ํ›„๋ณด ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ

    ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ํฌ๊ธฐ๋Š” TanStack Start ๋ฒค์น˜๋งˆํฌ๋ฅผ ๊ธฐ์ค€์œผ๋กœ ํ•ฉ๋‹ˆ๋‹ค. ๋นˆ ์ปดํฌ๋„ŒํŠธ์—์„œ provider์™€ hook์„ ๋ฒˆ๋“ค๋ง, ํŠธ๋ฆฌ ์‰์ดํ‚น, minification์„ ๊ฑฐ์นœ ํ›„ ์ธก์ •ํ•œ ์ˆ˜์น˜์ด๋ฉฐ(10๊ฐœ ํŽ˜์ด์ง€, 10๊ฐœ ๋กœ์ผ€์ผ), ์ฝ˜ํ…์ธ  ํฌ๊ธฐ๋Š” ๋ณ„๋„๋กœ ์ธก์ •๋˜์—ˆ์Šต๋‹ˆ๋‹ค.

    React i18n library ecosystem

    ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์„ธ๋Œ€์ฝ˜ํ…์ธ  ๋ชจ๋ธํƒ€์ž… ์•ˆ์ „์„ฑ๋ฉ”์‹œ์ง€ ํฌ๋งท๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ํฌ๊ธฐ
    react-i18nextRuntime์ค‘์•™ JSON, ๋„ค์ž„์ŠคํŽ˜์ด์Šค2/5 - ์˜ตํŠธ์ธ (CustomTypeOptions)i18next (์ ‘๋ฏธ์‚ฌ ๋ณต์ˆ˜ํ˜•)~18.4 kB
    react-intl (FormatJS)Runtime์ค‘์•™ JSON, ICU2/5 - ์˜ตํŠธ์ธ (์ถ”์ถœ + ์œ ๋‹ˆ์˜จ)ICU~15.3 kB
    use-intlServer-first์ค‘์•™ JSON, ICU2/5 - ์˜ตํŠธ์ธ (declaration merging)ICU~14.1 kB
    @tolgee/reactRuntime์ค‘์•™ ์ง‘์ค‘, ์ธ์ปจํ…์ŠคํŠธ ํŽธ์ง‘1/5 - ๋ฏธ์ง€์›ICU~11.1 kB
    LinguiMacro์ฝ”๋“œ ๋‚ด ์†Œ์Šค ํ…์ŠคํŠธ, ์ปดํŒŒ์ผ๋œ ์นดํƒˆ๋กœ๊ทธ2/5 - ์šฐ์ˆ˜ (์ปดํŒŒ์ผ๋Ÿฌ ์ง€์›)๋งคํฌ๋กœ๋ฅผ ํ†ตํ•œ ICU~11.8 kB
    ParaglideCompilerinlang ํ”„๋กœ์ ํŠธ, ์ƒ์„ฑ๋œ ํ•จ์ˆ˜3.5/5 - ์ž๋™ ์ƒ์„ฑ์ž์ฒด ํฌ๋งท๊ฑฐ์˜ 0์— ๊ฐ€๊นŒ์›€ (์ฝ”๋“œ๋ฒ ์ด์Šค์— ์ƒ์„ฑ๋˜๋Š” ์ฝ”๋“œ ๋•Œ๋ฌธ)
    IntlayerCompiler์ปดํฌ๋„ŒํŠธ๋ณ„ .content.ts5/5 - ์ž๋™ ์ƒ์„ฑ, ๊ธฐ๋ณธ ํ™œ์„ฑํ™”Intlayer (+ ICU, i18next, PO)~5.0 kB

    ์ˆ˜์น˜๋Š” ๋ฒค์น˜๋งˆํฌ ํ…Œ์ŠคํŠธ ๋‹น์‹œ ๋ฒ„์ „ ๊ธฐ์ค€์ด๋ฉฐ ๋ฆด๋ฆฌ์Šค์— ๋”ฐ๋ผ ๋‹ฌ๋ผ์ง‘๋‹ˆ๋‹ค. ํฌ๊ธฐ๋งŒ์œผ๋กœ ๊ฒฐ์ •ํ•˜๊ธฐ ์ „์— ์ž์ฒด ์•ฑ์—์„œ ์ง์ ‘ ๋ฒค์น˜๋งˆํฌ๋ฅผ ์‹คํ–‰ํ•ด ๋ณด์„ธ์š”. ํƒ€์ž… ์•ˆ์ „์„ฑ: 5/5๋Š” URL ํฌ๋งทํ„ฐ์™€ ํ—ฌํผ๋ฅผ ํฌํ•จํ•˜์—ฌ ํ‚ค, ๋งค๊ฐœ๋ณ€์ˆ˜, ๋ชจ๋“  ๋กœ์ผ€์ผ์ด ์ˆ˜๋™ ์„ค์ • ์—†์ด ๊ฒ€์‚ฌ๋จ์„ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค.

    ์œ„ ํ‘œ์— ๋‚˜ํƒ€๋‚˜์ง€ ์•Š๋Š” ๋‘ ๊ฐ€์ง€ ์‚ฌํ•ญ์ด ์žˆ์Šต๋‹ˆ๋‹ค. Paraglide๋Š” ์ฝ”๋“œ๋ฒ ์ด์Šค์— ์ฝ”๋“œ๋ฅผ ์ง์ ‘ ์ƒ์„ฑํ•˜๋ฏ€๋กœ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ํฌ๊ธฐ๊ฐ€ ๊ฑฐ์˜ ์—†์ง€๋งŒ, ๋งค ์ปค๋ฐ‹ ์ „ ์žฌ์ƒ์„ฑ ๋‹จ๊ณ„๊ฐ€ ํ•„์š”ํ•˜๊ณ  ์ƒ์„ฑ๋œ ํŒŒ์ผ์—์„œ ๋จธ์ง€ ์ถฉ๋Œ์ด ๋ฐœ์ƒํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๊ทธ๋ฆฌ๊ณ  Intlayer๋Š” ๋ฒˆ๋“ค๋Ÿฌ ํ”Œ๋Ÿฌ๊ทธ์ธ(vite-intlayer ๋“ฑ)์ด ํ•„์ˆ˜์ ์ด๋ฏ€๋กœ ๋นŒ๋“œ ๊ณผ์ •์ด ์—†๋Š” ํ™˜๊ฒฝ์—์„œ๋Š” ์‚ฌ์šฉํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค.

    ์ปค๋ฐ‹ ํ™œ๋™

    ์ปค๋ฐ‹ ์ˆ˜๋Š” ๊ฐ ํ”„๋กœ์ ํŠธ์— ์–ผ๋งˆ๋‚˜ ๋งŽ์€ ์ž‘์—…์ด ํˆฌ์ž…๋˜๋Š”์ง€๋ฅผ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค. ๋ชจ๋…ธ๋ ˆํฌ๋Š” ๋ฐฐํฌํ•˜๋Š” ๋ชจ๋“  ํŒจํ‚ค์ง€๋ฅผ ํฌํ•จํ•˜๋ฏ€๋กœ, ์ด ์ˆ˜์น˜๋Š” ํ’ˆ์งˆ์ด ์•„๋‹Œ ํ™œ๋™๋Ÿ‰์˜ ์‹ ํ˜ธ๋กœ ์ฝ์–ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

    • i18next/react-i18next
    • formatjs/formatjs
    • amannn/next-intl
    • tolgee/tolgee-js
    • lingui/js-lingui
    • opral/paraglide-js
    • aymericzip/intlayer

    ๊ธฐ๋ณธ ๋ธŒ๋žœ์น˜์˜ ์ปค๋ฐ‹ ์ˆ˜, ์ถœ์ฒ˜: GitHub API.

    npm ๋‹ค์šด๋กœ๋“œ

    • react-i18next
    • react-intl
    • use-intl
    • @tolgee/react
    • @lingui/react
    • @inlang/paraglide-js
    • react-intlayer

    ์ถœ์ฒ˜: npm ๋ ˆ์ง€์ŠคํŠธ๋ฆฌ ๋‹ค์šด๋กœ๋“œ API.

    ๋‹ค์šด๋กœ๋“œ ์ˆ˜๋Š” ๊ฐ€์žฅ ์ข‹์€ ์†”๋ฃจ์…˜์ด ์•„๋‹ˆ๋ผ ๊ฐ€์žฅ ์˜ค๋ž˜๋œ ์†”๋ฃจ์…˜์— ๋ณด์ƒ์„ ์ค๋‹ˆ๋‹ค. ์ˆ˜๋…„ ์ „์— ์ถœ์‹œ๋œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ๋‹น์‹œ ์ด๋ฅผ ์„ ํƒํ•œ ๋ชจ๋“  ํ”„๋กœ์ ํŠธ, ๋ชจ๋“  CI ์‹คํ–‰, ์ด์— ์˜์กดํ•˜๋Š” ๋ชจ๋“  ํŒจํ‚ค์ง€์— ์˜ํ•ด ์—ฌ์ „ํžˆ ์„ค์น˜๋ฉ๋‹ˆ๋‹ค. ์ด ์ˆ˜์น˜๋Š” ์ƒˆ๋กœ์šด ์„ ํƒ๋ณด๋‹ค ๊ด€์„ฑ์„ ์ธก์ •ํ•ฉ๋‹ˆ๋‹ค.

    AI ์–ด์‹œ์Šคํ„ดํŠธ๋Š” ์ด ํšจ๊ณผ๋ฅผ ๋” ํ‚ค์›๋‹ˆ๋‹ค. next-intl, i18next, vue-i18n์€ AI๊ฐ€ ํ•™์Šตํ•œ ์ฝ”๋“œ ๊ณณ๊ณณ์— ์žˆ์œผ๋ฏ€๋กœ, AI๋Š” ๋Œ€์•ˆ์„ ๋น„๊ตํ•˜์ง€ ์•Š๊ณ  ์ด๋“ค์„ ๊ธฐ๋ณธ์œผ๋กœ ์ถ”์ฒœํ•ฉ๋‹ˆ๋‹ค. ์ถ”์ฒœ์ด ๋‹ค์šด๋กœ๋“œ๋ฅผ ๋Š˜๋ฆฌ๊ณ , ๊ทธ ๋‹ค์šด๋กœ๋“œ๊ฐ€ ๋‹ค์Œ ์ถ”์ฒœ์„ ๋ถ€์ถ”๊น๋‹ˆ๋‹ค. ๋‹ค์šด๋กœ๋“œ ์ˆ˜๊ฐ€ ์•„๋‹ˆ๋ผ ๋ฒค์น˜๋งˆํฌ๋กœ ๋น„๊ตํ•˜์„ธ์š”.

    ๋‹ต๋ณ€์— ๋งž๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์ฐพ๊ธฐ

    ์ž‘๋™ํ•˜๋Š” ๊ฐ€์žฅ ๋‹จ์ˆœํ•œ ๋„๊ตฌ๋ฅผ ์„ ํƒํ•˜๊ณ  ๊ณผ๋„ํ•œ ํˆฌ์ž๋ฅผ ํ”ผํ•˜์„ธ์š”. ๋กœ์ผ€์ผ๋‹น ๋‹จ์ผ JSON์„ ์‚ฌ์šฉํ•˜๋Š” react-i18next๋กœ๋„ ์ถฉ๋ถ„ํ•˜๋ฉฐ, ์ง€๋‚œ 10๋…„๊ฐ„ ์Œ“์ธ Stack Overflow ๋‹ต๋ณ€๋“ค์ด ์‹œ๊ฐ„์„ ์ ˆ์•ฝํ•ด ์ค„ ๊ฒƒ์ž…๋‹ˆ๋‹ค. ํ•„์š”ํ•ด์ง€๊ธฐ ์ „๊นŒ์ง€๋Š” ๋„ค์ž„์ŠคํŽ˜์ด์Šค ์„ค์ •์„ ๊ฑด๋„ˆ๋›ฐ์–ด๋„ ์ข‹์Šต๋‹ˆ๋‹ค. ํ”„๋กœํ† ํƒ€์ž…์ด ์ •์‹ ์ œํ’ˆ์ด ๋œ๋‹ค๋ฉด ๋ฒ”์œ„ ์ œํ•œ ์ฝ˜ํ…์ธ ๋กœ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ํ•  ๊ณ„ํš์„ ์„ธ์šฐ์„ธ์š”. react-i18next ํ˜ธํ™˜ ์–ด๋Œ‘ํ„ฐ๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด ์ ์ง„์ ์œผ๋กœ ์ „ํ™˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.

    ์นดํƒˆ๋กœ๊ทธ ํ˜•์‹์ด ์ด๋ฏธ ๊ฒฐ์ •๋œ ์ƒํƒœ์ž…๋‹ˆ๋‹ค. react-intl์€ ICU ๋„ค์ดํ‹ฐ๋ธŒ์ด๋ฉฐ FormatJS ์ถ”์ถœ ๋„๊ตฌ๋Š” ํ•ด๋‹น ํŒŒ์ดํ”„๋ผ์ธ์— ๋งž์ถฐ์ ธ ์žˆ์Šต๋‹ˆ๋‹ค. use-intl ์—ญ์‹œ ICU๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค. react-i18next๋Š” ICU ํ”Œ๋Ÿฌ๊ทธ์ธ์ด ํ•„์š”ํ•˜๋ฉฐ, ๊ทธ๋ ‡์ง€ ์•Š์œผ๋ฉด ์ž์ฒด ๋ณต์ˆ˜ํ˜• ํ‚ค๋ฅผ ์‚ฌ์šฉํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. Intlayer์˜ ICU ์ง€์›์€ ์•„์ง ์ผ๋ถ€ ์ž‘์—… ์ค‘์ด๋ฏ€๋กœ, ํ˜„์žฌ ICU ๋ฌธ์ž์—ด์„ ์ง์ ‘ ์ „๋‹ฌ๋ฐ›๋Š”๋‹ค๋ฉด ์™„๋ฒฝํžˆ ์ง€์›๋  ๋•Œ๊นŒ์ง€ ์ด๋ฅผ ๊ฒ€ํ†  ์š”์†Œ๋กœ ์‚ผ์•„์•ผ ํ•ฉ๋‹ˆ๋‹ค.

    ๊ทœ์น™์ด ์•„๋‹Œ ๊ธฐ๋ณธ ๋™์ž‘์œผ๋กœ์„œ ๋ฒ”์œ„ ์ œํ•œ ์ฝ˜ํ…์ธ ์™€ ๋™์  ๋กœ๋”ฉ์„ ์ง€์›ํ•˜๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋ฅผ ์„ ํ˜ธํ•˜์„ธ์š”. Lingui์™€ Paraglide๋Š” ์ปดํŒŒ์ผ์„ ํ†ตํ•ด ์ด๋ฅผ ๋‹ฌ์„ฑํ•ฉ๋‹ˆ๋‹ค. Intlayer๋Š” ์ปดํฌ๋„ŒํŠธ๋ณ„ ์„ ์–ธ์„ ํ†ตํ•ด ์ด๋ฅผ ๊ตฌํ˜„ํ•˜๋ฉฐ, ์ปดํŒŒ์ผ๋Ÿฌ๊ฐ€ ๋ผ์šฐํŠธ์—์„œ ๋ Œ๋”๋งํ•˜๋Š” ์ฝ˜ํ…์ธ ๋งŒ ์ „์†กํ•ฉ๋‹ˆ๋‹ค. react-i18next๋‚˜ use-intl์„ ์‚ฌ์šฉํ•œ๋‹ค๋ฉด ๋„ค์ž„์ŠคํŽ˜์ด์Šค์™€ lazy ๋กœ๋”ฉ ์ „๋žต์„ ์ฒซ๋‚ ๋ถ€ํ„ฐ ๊ณ„ํšํ•˜๊ณ  ์ฝ”๋“œ ๋ฆฌ๋ทฐ์—์„œ ์—„๊ฒฉํžˆ ๊ด€๋ฆฌํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ๋„๊ตฌ๊ฐ€ ์ด๋ฅผ ์ž๋™์œผ๋กœ ๊ฐ•์ œํ•ด์ฃผ์ง€ ์•Š๊ธฐ ๋•Œ๋ฌธ์ž…๋‹ˆ๋‹ค.

    ๋ชจ๋“  ํ‚ค ๊ธฐ๋ฐ˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ํƒ€์ž…์„ ์ง€์›ํ•  ์ˆ˜ ์žˆ์ง€๋งŒ, ๊ธฐ๋ณธ์œผ๋กœ ํ™œ์„ฑํ™”๋œ ๊ฒฝ์šฐ๋Š” ๊ฑฐ์˜ ์—†์Šต๋‹ˆ๋‹ค. lazy ๋กœ๋”ฉ๋˜๋Š” ๋„ค์ž„์ŠคํŽ˜์ด์Šค์— ๋งž์ถฐ declaration merging์„ ์ง์ ‘ ์œ ์ง€๋ณด์ˆ˜ํ•˜๊ณ  ์‹ถ์ง€ ์•Š๋‹ค๋ฉด, ์ฝ˜ํ…์ธ ๋กœ๋ถ€ํ„ฐ ํƒ€์ž…์ด ์ž๋™ ์ƒ์„ฑ๋˜๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ(Lingui, Paraglide, Intlayer)๋ฅผ ์„ ํƒํ•˜์„ธ์š”. ๋ˆ„๋ฝ๋œ ๋ฒˆ์—ญ ๊ฐ์ง€ ๊ธ€์—์„œ ๊ฐ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ๋นŒ๋“œ ํƒ€์ž„์— ๋ฌด์—‡์„ ๊ฐ์ง€ํ•˜๋Š”์ง€ ๋น„๊ตํ•ฉ๋‹ˆ๋‹ค.

    ๋ฆฌ์น˜ ๋…ธ๋“œ๋Š” t()๊ฐ€ ๋‹จ์ˆœ ๋ฌธ์ž์—ด์„ ๋ฐ˜ํ™˜ํ•˜๋Š” ๋ฐฉ์‹์˜ ํ•œ๊ณ„๊ฐ€ ๋“œ๋Ÿฌ๋‚˜๋Š” ์ง€์ ์ž…๋‹ˆ๋‹ค. react-i18next์™€ Lingui๋Š” <Trans>๋ฅผ ์ œ๊ณตํ•˜๊ณ , react-intl์€ ๋ฆฌ์น˜ ํ…์ŠคํŠธ ํƒœ๊ทธ๋ฅผ ์ œ๊ณตํ•˜์ง€๋งŒ, ๋ชจ๋‘ ์ผ๋ฐ˜ ๋ฌธ์ž์—ด ๋ฐฉ์‹๋ณด๋‹ค ์‚ฌ์šฉํ•˜๊ธฐ ๋ฒˆ๊ฑฐ๋กญ์Šต๋‹ˆ๋‹ค. Intlayer์˜ ์ฝ˜ํ…์ธ  ๋…ธ๋“œ๋Š” JSX, ๋งˆํฌ๋‹ค์šด, ์ค‘์ฒฉ ๊ฐ์ฒด๋ฅผ ์ง์ ‘ ์ง€์›ํ•˜๋ฏ€๋กœ ์ฝ˜ํ…์ธ ๊ฐ€ ๋‹จ์ˆœ UI ๋ผ๋ฒจ ์ด์ƒ์ผ ๋•Œ ํ›จ์”ฌ ์ ํ•ฉํ•ฉ๋‹ˆ๋‹ค.

    ๊ฐ€์ ธ์˜ฌ TMS๊ฐ€ ์—†๋‹ค๋ฉด ์ค‘์•™์ง‘์ค‘์‹ JSON์€ ๋” ์ด์ƒ ํ•„์ˆ˜๊ฐ€ ์•„๋‹™๋‹ˆ๋‹ค. ์ฝ”๋กœ์ผ€์ด์…˜(colocated)๋œ ์ฝ˜ํ…์ธ ์™€ ๋ˆ„๋ฝ๋œ ๋กœ์ผ€์ผ์„ ์ฑ„์›Œ์ฃผ๋Š” CLI ์กฐํ•ฉ์ด ๊ฐ€์žฅ ๋น ๋ฅธ ๋ฐฉ๋ฒ•์ž…๋‹ˆ๋‹ค. Intlayer์˜ fill ๋ช…๋ น์–ด๋Š” ์‚ฌ์šฉ์ž์˜ ์ž์ฒด API ํ‚ค(OpenAI, Anthropic, Mistral, Gemini)๋ฅผ ์‚ฌ์šฉํ•˜์—ฌ ๋ณ€๊ฒฝ๋œ ๋‚ด์šฉ๋งŒ ๋ฒˆ์—ญํ•ฉ๋‹ˆ๋‹ค. Paraglide์™€ Tolgee๋Š” ์ž์ฒด ํ”Œ๋žœ์„ ํ†ตํ•ด ํ˜ธ์ŠคํŒ…๋˜๋Š” ์œ ์‚ฌ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

    React context๋Š” ์„œ๋ฒ„์™€ ํด๋ผ์ด์–ธํŠธ ๊ฒฝ๊ณ„๋ฅผ ๋„˜์ง€ ๋ชปํ•ฉ๋‹ˆ๋‹ค. ํด๋ผ์ด์–ธํŠธ hook์—๋งŒ ์˜์กดํ•˜๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ(react-i18next, react-intl)๋Š” RSC๋ฅผ ๋„์ž…ํ•˜๋Š” ์ˆœ๊ฐ„ ๋ณ„๋„์˜ ์„œ๋ฒ„ API๊ฐ€ ํ•„์š”ํ•˜๊ฒŒ ๋ฉ๋‹ˆ๋‹ค. use-intl(next-intl๋กœ ์ œ๊ณต)๊ณผ Intlayer(next-intlayer๋กœ ์ œ๊ณต)๋Š” ์ด๋ฏธ ์ด๋Ÿฌํ•œ ๋ถ„๋ฆฌ๋ฅผ ์ง€์›ํ•ฉ๋‹ˆ๋‹ค. ํŒจํ„ด์„ ํ‘œ์ค€ํ™”ํ•˜๊ธฐ ์ „์— Next.js i18n ๊ฐ€์ด๋“œ๋ฅผ ์ฝ์–ด๋ณด์„ธ์š”.

    ๊ฐ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์˜ ํ•œ๊ณ„์ 

    ๋ชจ๋“  ์„ ํƒ์—๋Š” ํŠธ๋ ˆ์ด๋“œ์˜คํ”„๊ฐ€ ๋”ฐ๋ฅด๋ฏ€๋กœ ์†”์งํ•œ ํ•œ๊ณ„์ ์„ ๊ณต์œ ํ•ฉ๋‹ˆ๋‹ค.

    • react-i18next: ํ›„๋ณด ์ค‘ ๊ฐ€์žฅ ๋ฌด๊ฑฐ์šด ๋Ÿฐํƒ€์ž„, ๋…์ž์ ์ธ ๋ณต์ˆ˜ํ˜• ํฌ๋งท, ์ง์ ‘ ์œ ์ง€๋ณด์ˆ˜ํ•ด์•ผ ํ•˜๋Š” ํƒ€์ž… ์—ฐ๊ฒฐ, ์กฐ์šฉํžˆ ์Œ“์ด๋Š” ๋ฏธ์‚ฌ์šฉ ๋ฐ๋“œ ํ‚ค.
    • react-intl: ๋‹ค์†Œ ์žฅํ™ฉํ•œ ๊ฐœ๋ฐœ์ž ๊ฒฝํ—˜(useIntl() ํ›„ formatMessage({ id })), ์—ฌ๋Ÿฌ ๋…ธ๋“œ์™€ ๊ฒฐํ•ฉ๋œ ์ „์—ญ ์ธ์Šคํ„ด์Šค.
    • use-intl: ์‹œ์ž‘์€ ๊ฐ„๋‹จํ•˜์ง€๋งŒ ์ตœ์ ํ™”๊ฐ€ ๊นŒ๋‹ค๋กœ์›€. ๋„ค์ž„์ŠคํŽ˜์ด์Šค, ๋™์  ๋กœ๋”ฉ, ํƒ€์ž… ์„ค์ •์„ ๋™์‹œ์— ๊ด€๋ฆฌํ•˜๋ ค๋ฉด ๊ฐœ๋ฐœ ์†๋„๊ฐ€ ๋А๋ ค์งˆ ์ˆ˜ ์žˆ์Œ.
    • Lingui: ์ถ”๊ฐ€์ ์ธ extract / compile ๋นŒ๋“œ ๋‹จ๊ณ„ ํ•„์š”, ์—ฌ๋Ÿฌ ์ค‘๋ณต ๋ฌธ๋ฒ•(t(), ํƒœ๊ทธ๋“œ ํ…œํ”Œ๋ฆฟ, i18n.t(), <Trans>)์œผ๋กœ ์ธํ•ด ์‚ฌ๋žŒ๊ณผ AI ์–ด์‹œ์Šคํ„ดํŠธ ๋ชจ๋‘ ํ˜ผ๋ž€์„ ๊ฒช์„ ์ˆ˜ ์žˆ์Œ.
    • Paraglide: ๋ฆฌํฌ์ง€ํ† ๋ฆฌ ๋‚ด์— ํŒŒ์ผ ์ƒ์„ฑ, React ๋ฒค์น˜๋งˆํฌ์—์„œ ํŠธ๋ฆฌ ์‰์ดํ‚น์ด ์˜จ์ „ํžˆ ์ ์šฉ๋˜์ง€ ์•Š์Œ, ๋กœ์ผ€์ผ์„ ์ค‘์•™ store๊ฐ€ ์•„๋‹Œ ๊ฐœ๋ณ„ ๋…ธ๋“œ์˜ ์Šคํ† ๋ฆฌ์ง€์—์„œ ๋งค๋ฒˆ ์ฝ์–ด์˜ด.
    • Tolgee: ํ‚ค ํƒ€์ž… ๋ฏธ์ง€์›, ์ƒ๋Œ€์ ์œผ๋กœ ์–ด๋ ค์šด ์˜จ๋ณด๋”ฉ, ์ธ์ปจํ…์ŠคํŠธ ํŽธ์ง‘ ๊ธฐ๋Šฅ์ด ์ฃผ์š” ๊ฐ•์ .
    • Intlayer: ํ•„์ˆ˜ ๋ฒˆ๋“ค๋Ÿฌ ํ”Œ๋Ÿฌ๊ทธ์ธ ํ•„์š”, ์ƒ๋Œ€์ ์œผ๋กœ ์ž‘์€ ์ƒํƒœ๊ณ„, ๋ถ€๋ถ„์ ์ธ ICU ์ง€์›, ๊ตฌ์กฐ์ƒ ์ฝ˜ํ…์ธ ๊ฐ€ ์ฝ”๋“œ๋ฒ ์ด์Šค ์ „๋ฐ˜์— ๋ถ„์‚ฐ๋˜์–ด ์žˆ์–ด ๋ฒˆ์—ญ๊ฐ€์—๊ฒŒ ๋‹จ์ผ JSON์„ ์ถ”์ถœํ•ด ์ „๋‹ฌํ•˜๋ ค๋ฉด ๋ณ„๋„ ๋„๊ตฌ๊ฐ€ ํ•„์š”ํ•จ.
    • gt-react, lingo.dev: ๋ฒค์น˜๋งˆํฌ์—์„œ ๊ถŒ์žฅ๋˜์ง€ ์•Š์Œ: ๋นŒ๋“œ ์‹œ ์ฟผํ„ฐ ์˜ค๋ฅ˜ ๋ฐœ์ƒ, ๋ฒค๋” ์ข…์†์„ฑ, provider์˜ ๋ฆฌ๋ Œ๋”๋ง์„ ๊ฐ•์ œํ•ด์•ผ ํ•˜๋Š” ๋ฐ˜์‘์„ฑ ๋ฌธ์ œ.

    ์ฝ”๋“œ๋กœ ์‚ดํŽด๋ณด๋Š” ๊ฐ ์˜ต์…˜

    ์ œ๋ชฉ๊ณผ ๋ณต์ˆ˜ํ˜•์ด ํฌํ•จ๋œ ๋™์ผํ•œ ์žฅ๋ฐ”๊ตฌ๋‹ˆ ์š”์•ฝ ์ปดํฌ๋„ŒํŠธ๋ฅผ ๊ฐ ํ›„๋ณด ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋กœ ์ž‘์„ฑํ•œ ์˜ˆ์‹œ์ž…๋‹ˆ๋‹ค. ์ค‘์š”ํ•œ ๊ฒƒ์€ ์ปดํฌ๋„ŒํŠธ ์ž์ฒด๊ฐ€ ์•„๋‹ˆ๋ผ ์ฝ˜ํ…์ธ ๊ฐ€ ์–ด๋””์— ์ €์žฅ๋˜๋ฉฐ ํƒ€์ž… ์ฒด์ปค๊ฐ€ ์ด๋ฅผ ์–ด๋–ป๊ฒŒ ์ธ์‹ํ•˜๋Š”์ง€์ž…๋‹ˆ๋‹ค.

    public/locales/en/cart.json
    {
      "title": "Your cart",
      "items_one": "{{count}} item",
      "items_other": "{{count}} items"
    }
    
    public/locales/fr/cart.json
    {
      "title": "Votre panier",
      "items_one": "{{count}} article",
      "items_other": "{{count}} articles"
    }
    
    public/locales/es/cart.json
    {
      "title": "Tu carrito",
      "items_one": "{{count}} artรญculo",
      "items_other": "{{count}} artรญculos"
    }
    
    src/components/CartSummary.tsx
    import type { FC } from "react";
    import { useTranslation } from "react-i18next";
    
    export const CartSummary: FC<{ count: number }> = ({ count }) => {
      const { t } = useTranslation("cart");
    
      return (
        <section>
          <h2>{t("title")}</h2>
          <p>{t("items", { count })}</p>
        </section>
      );
    };
    

    ๋ณต์ˆ˜ํ˜•์€ Intl.PluralRules๋ฅผ ํ†ตํ•ด ํ•ด์„๋˜๋Š” ์ ‘๋ฏธ์‚ฌ ํ‚ค์ž…๋‹ˆ๋‹ค. CustomTypeOptions๋ฅผ ์„ ์–ธํ•˜์ง€ ์•Š์œผ๋ฉด t๋Š” (key: string) => string ํƒ€์ž…์ด ๋˜๋ฏ€๋กœ t("titel") ๊ฐ™์€ ์˜คํƒ€๋„ ์ •์ƒ์ ์œผ๋กœ ์ปดํŒŒ์ผ๋ฉ๋‹ˆ๋‹ค.

    src/locales/en.json
    {
      "cart.title": "Your cart",
      "cart.items": "{count, plural, one {# item} other {# items}}"
    }
    
    src/locales/fr.json
    {
      "cart.title": "Votre panier",
      "cart.items": "{count, plural, one {# article} other {# articles}}"
    }
    
    src/locales/es.json
    {
      "cart.title": "Tu carrito",
      "cart.items": "{count, plural, one {# artรญculo} other {# artรญculos}}"
    }
    
    src/components/CartSummary.tsx
    import type { FC } from "react";
    import { FormattedMessage, useIntl } from "react-intl";
    
    export const CartSummary: FC<{ count: number }> = ({ count }) => {
      const intl = useIntl();
    
      return (
        <section>
          <h2>
            <FormattedMessage id="cart.title" />
          </h2>
          <p>{intl.formatMessage({ id: "cart.items" }, { count })}</p>
        </section>
      );
    };
    

    ๋Œ€๋ถ€๋ถ„์˜ TMS ํ”Œ๋žซํผ์ด ๋‚ด๋ณด๋‚ด๋Š” ํ˜•์‹์ธ ICU๋ฅผ ์ฒ˜์Œ๋ถ€ํ„ฐ ๋๊นŒ์ง€ ์‚ฌ์šฉํ•ฉ๋‹ˆ๋‹ค. id์— ๋Œ€ํ•œ ํƒ€์ž…์€ ๊ธฐ๋ณธ ์ œ๊ณต๋˜์ง€ ์•Š์œผ๋ฉฐ, formatjs ์ถ”์ถœ ๋‹จ๊ณ„์™€ ์ƒ์„ฑ๋œ ์œ ๋‹ˆ์˜จ ํƒ€์ž…์„ ํ†ตํ•ด ์ง€์›๋ฉ๋‹ˆ๋‹ค.

    messages/en.json
    {
      "Cart": {
        "title": "Your cart",
        "items": "{count, plural, one {# item} other {# items}}"
      }
    }
    
    messages/fr.json
    {
      "Cart": {
        "title": "Votre panier",
        "items": "{count, plural, one {# article} other {# articles}}"
      }
    }
    
    messages/es.json
    {
      "Cart": {
        "title": "Tu carrito",
        "items": "{count, plural, one {# artรญculo} other {# artรญculos}}"
      }
    }
    
    src/components/CartSummary.tsx
    import type { FC } from "react";
    import { useTranslations } from "use-intl";
    
    export const CartSummary: FC<{ count: number }> = ({ count }) => {
      const t = useTranslations("Cart");
    
      return (
        <section>
          <h2>{t("title")}</h2>
          <p>{t("items", { count })}</p>
        </section>
      );
    };
    

    Next.js ๋ฐ”์ธ๋”ฉ์ด ์ œ์™ธ๋œ next-intl๊ณผ ๋™์ผํ•œ ๊ตฌ์กฐ์ž…๋‹ˆ๋‹ค. AppConfig์— ๋ฉ”์‹œ์ง€ ํƒ€์ž…์„ ํ™•์žฅ(augment)ํ•˜๋ฉด ํ‚ค์— ํƒ€์ž…์ด ์ ์šฉ๋˜๋ฉฐ, ๋„ค์ž„์ŠคํŽ˜์ด์Šค ๋ถ„ํ• ์€ ์‚ฌ์šฉ์ž๊ฐ€ ์ง์ ‘ ๊ด€๋ฆฌํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

    src/locales/en/messages.po
    msgid "Your cart"
    msgstr "Your cart"
    
    msgid "{count, plural, one {# item} other {# items}}"
    msgstr "{count, plural, one {# item} other {# items}}"
    
    src/locales/fr/messages.po
    msgid "Your cart"
    msgstr "Votre panier"
    
    msgid "{count, plural, one {# item} other {# items}}"
    msgstr "{count, plural, one {# article} other {# articles}}"
    
    src/locales/es/messages.po
    msgid "Your cart"
    msgstr "Tu carrito"
    
    msgid "{count, plural, one {# item} other {# items}}"
    msgstr "{count, plural, one {# artรญculo} other {# artรญculos}}"
    
    src/components/CartSummary.tsx
    import type { FC } from "react";
    import { Plural, Trans } from "@lingui/react/macro";
    
    export const CartSummary: FC<{ count: number }> = ({ count }) => (
      <section>
        <h2>
          <Trans>Your cart</Trans>
        </h2>
        <p>
          <Plural value={count} one="# item" other="# items" />
        </p>
      </section>
    );
    

    ๊ธฐ๋ณธ ์†Œ์Šค ์–ธ์–ด๋Š” ์ปดํฌ๋„ŒํŠธ ๋‚ด์— ์œ„์น˜ํ•˜๋ฉฐ, ๋‹ค๋ฅธ ๋กœ์ผ€์ผ์€ lingui extract ํ›„ ํ•ด์‹œ๋œ ID๋ฅผ ๊ฐ€์ง„ .po ํŒŒ์ผ์— ์ €์žฅ๋ฉ๋‹ˆ๋‹ค. extract๋‚˜ compile์„ ์žŠ์œผ๋ฉด ๊ฒฝ๊ณ  ์—†์ด ๊ธฐ๋ณธ ์˜์–ด๋กœ ํด๋ฐฑ๋ฉ๋‹ˆ๋‹ค.

    messages/en.json
    {
      "cart_title": "Your cart",
      "cart_items": "{count} items"
    }
    
    messages/fr.json
    {
      "cart_title": "Votre panier",
      "cart_items": "{count} articles"
    }
    
    messages/es.json
    {
      "cart_title": "Tu carrito",
      "cart_items": "{count} artรญculos"
    }
    
    src/components/CartSummary.tsx
    import type { FC } from "react";
    import { m } from "../paraglide/messages.js";
    
    export const CartSummary: FC<{ count: number }> = ({ count }) => (
      <section>
        <h2>{m.cart_title()}</h2>
        <p>{m.cart_items({ count })}</p>
      </section>
    );
    

    ๋ชจ๋“  ๋ฉ”์‹œ์ง€๊ฐ€ ํƒ€์ž…์ด ์ง€์ •๋œ ์ƒ์„ฑ ํ•จ์ˆ˜์ด๋ฏ€๋กœ ํ‚ค๊ฐ€ ๋ˆ„๋ฝ๋˜๋ฉด import ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. paraglide/ ํด๋”๊ฐ€ ์ฝ”๋“œ๋ฒ ์ด์Šค ๋‚ด์— ์ƒ์„ฑ๋˜๋ฉฐ ๋ณ€๊ฒฝ๋  ๋•Œ๋งˆ๋‹ค ๋‹ค์‹œ ์ƒ์„ฑ๋ฉ๋‹ˆ๋‹ค.

    src/components/cartSummary.content.ts
    import { plural, t, type Dictionary } from "intlayer";
    
    const cartSummaryContent = {
      key: "cart-summary",
      content: {
        title: t({
          ko: "์žฅ๋ฐ”๊ตฌ๋‹ˆ",
          en: "Your cart",
          fr: "Votre panier",
          es: "Tu carrito",
        }),
        items: t({
          ko: plural({ one: "{{count}}๊ฐœ ํ•ญ๋ชฉ", other: "{{count}}๊ฐœ ํ•ญ๋ชฉ" }),
          en: plural({ one: "{{count}} item", other: "{{count}} items" }),
          fr: plural({ one: "{{count}} article", other: "{{count}} articles" }),
          es: plural({ one: "{{count}} artรญculo", other: "{{count}} artรญculos" }),
        }),
      },
    } satisfies Dictionary;
    
    export default cartSummaryContent;
    
    src/components/CartSummary.tsx
    import type { FC } from "react";
    import { useIntlayer } from "react-intlayer";
    
    export const CartSummary: FC<{ count: number }> = ({ count }) => {
      const { title, items } = useIntlayer("cart-summary");
    
      return (
        <section>
          <h2>{title}</h2>
          <p>{items(count)}</p>
        </section>
      );
    };
    

    ๋ชจ๋“  ๋กœ์ผ€์ผ์ด ์ปดํฌ๋„ŒํŠธ ๋ฐ”๋กœ ์˜†์˜ ๋‹จ์ผ ํŒŒ์ผ์— ์œ„์น˜ํ•ฉ๋‹ˆ๋‹ค. ํƒ€์ž…์ด ๋นŒ๋“œ ์‹œ ์ƒ์„ฑ๋˜๋ฏ€๋กœ title์ด ์ž๋™ ์™„์„ฑ๋˜๊ณ , ์˜คํƒ€๊ฐ€ ์žˆ์œผ๋ฉด declaration merging ์—†์ด๋„ tsc ์—๋Ÿฌ๊ฐ€ ๋ฐœ์ƒํ•ฉ๋‹ˆ๋‹ค. ์ปดํฌ๋„ŒํŠธ ํด๋”๋ฅผ ์‚ญ์ œํ•˜๋ฉด ๊ด€๋ จ ๋ฌธ์ž์—ด๋„ ํ•จ๊ป˜ ์ •๋ฆฌ๋ฉ๋‹ˆ๋‹ค.

    ์ด๋ฏธ react-i18next, react-intl, Lingui๋ฅผ ์‚ฌ์šฉ ์ค‘์ด์‹ ๊ฐ€์š”? ํ˜ธํ™˜ ์–ด๋Œ‘ํ„ฐ(react-i18next, react-intl, Lingui)๊ฐ€ ๋ฒˆ๋“ค๋Ÿฌ ์ˆ˜์ค€์—์„œ import๋ฅผ ๋ณ„์นญ ์ฒ˜๋ฆฌ(alias)ํ•˜์—ฌ ์ปดํฌ๋„ŒํŠธ ๋‹จ์œ„๋กœ ์ด์ „ํ•˜๋Š” ๋™์•ˆ์—๋„ ๊ธฐ์กด API๊ฐ€ ๊ทธ๋Œ€๋กœ ์ž‘๋™ํ•˜๋„๋ก ์ง€์›ํ•ฉ๋‹ˆ๋‹ค. ๊ทธ ์™ธ์˜ ๋‚ด์šฉ์€ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๊ฐ€์ด๋“œ๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”.

    ์ตœ์ข… ๊ฒฐ์ • ์ „ ํ™•์ธํ•  ์‚ฌํ•ญ

    ๊ธฐ๋Šฅ ํ‘œ๋Š” ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ํ˜„์žฌ ๋ฌด์—‡์„ ํ•  ์ˆ˜ ์žˆ๋Š”์ง€๋งŒ ๋ณด์—ฌ์ค๋‹ˆ๋‹ค. ๋‹ค์Œ ํ•ญ๋ชฉ๋“ค์€ ์‹ค์ œ๋กœ ์šด์˜ํ•˜๋ฉด์„œ ๋งˆ์ฃผํ•˜๊ฒŒ ๋  ๊ฒฝํ—˜์„ ์•Œ๋ ค์ค๋‹ˆ๋‹ค.

    ์ €์žฅ์†Œ ํ™œ๋™์„ฑ์„ ํ™•์ธํ•˜์„ธ์š”.

    ์ปค๋ฐ‹ ์ฃผ๊ธฐ, ์ด์Šˆ ์‘๋‹ต ์‹œ๊ฐ„, ์ตœ๊ทผ ๋งˆ์ด๋„ˆ ๋ฆด๋ฆฌ์Šค๊ฐ€ ์˜ฌํ•ด ์žˆ์—ˆ๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”. ์œ ์ง€๋ณด์ˆ˜์ž๊ฐ€ ์—†๋Š” ํ›Œ๋ฅญํ•œ ์„ค๊ณ„๋Š” ๊ฒฐ๊ตญ ๋งˆ์ด๊ทธ๋ ˆ์ด์…˜ ๋ถ€์ฑ„๊ฐ€ ๋ฉ๋‹ˆ๋‹ค.

    npm ๋‹ค์šด๋กœ๋“œ ์ˆ˜๋งŒ ๋ณด๊ณ  ์„ ํƒํ•˜์ง€ ๋งˆ์„ธ์š”.

    ๊ฐ€์žฅ ๋งŽ์ด ์„ค์น˜๋œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ๊ฐ€์žฅ ๋จผ์ € ์ถœ์‹œ๋œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ์ผ ๋ฟ, 2026๋…„ React ์ฝ”๋“œ๋ฒ ์ด์Šค์— ๊ฐ€์žฅ ์ ํ•ฉํ•œ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ์•„๋‹ ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค. ๋‹ค์šด๋กœ๋“œ ์ˆ˜๋Š” ์ ํ•ฉ์„ฑ์ด ์•„๋‹Œ ์—ญ์‚ฌ๋ฅผ ๋‚˜ํƒ€๋ƒ…๋‹ˆ๋‹ค.

    Tier list of JavaScript i18n libraries

    ์œ ์ง€๋ณด์ˆ˜ ๋น„์šฉ์„ ๋ˆ„๊ฐ€ ์ง€์›ํ•˜๊ณ , ๋ฌด์—‡์„ ํŒ๋งคํ•˜๋Š”์ง€ ์‚ดํŽด๋ณด์„ธ์š”.

    i18next๋Š” Locize์˜ ์ง€์›์„ ๋ฐ›์Šต๋‹ˆ๋‹ค. next-intl / use-intl, vue-i18n, svelte-i18n, Lingui๋Š” Crowdin์˜ ์ง€์›์„ ๋ฐ›์Šต๋‹ˆ๋‹ค. Tolgee, Paraglide(inlang), Intlayer๋Š” ๊ฐ๊ฐ ์ž์ฒด ํ”Œ๋žซํผ์„ ์šด์˜ํ•ฉ๋‹ˆ๋‹ค. ํ˜ธ์ŠคํŒ… ๋ฒˆ์—ญ ์„œ๋น„์Šค๊ฐ€ ์ฃผ ์ˆ˜์ต์›์ธ ํšŒ์‚ฌ๋Š” ๋„๊ตฌ ์ฒด์ธ ๋‚ด์—์„œ ๋ฒˆ์—ญ์„ ๋ฌด๋ฃŒ๋กœ ์ œ๊ณตํ•  ์œ ์ธ์ด ์ ์Šต๋‹ˆ๋‹ค. Intlayer๋Š” ์ž์ฒด API ํ‚ค๋ฅผ ํ™œ์šฉํ•œ CLI ๊ธฐ๋ฐ˜ AI ๋ฒˆ์—ญ๊ณผ ์…€ํ”„ ํ˜ธ์ŠคํŒ… ๊ฐ€๋Šฅํ•œ CMS๋ฅผ ํ•จ๊ป˜ ์ œ๊ณตํ•˜๋Š” ์œ ์ผํ•œ ๋„๊ตฌ์ž…๋‹ˆ๋‹ค.

    AI ์—์ด์ „ํŠธ ์นœํ™”์ ์ธ๊ฐ€์š”?

    AI ์—์ด์ „ํŠธ๋Š” ์—ฌ์ „ํžˆ i18n ์ž‘์—…์—์„œ ์‹ค์ˆ˜๋ฅผ ๋ฒ”ํ•ฉ๋‹ˆ๋‹ค. ๋กœ์ผ€์ผ์„ ๋ˆ„๋ฝํ•˜๊ฑฐ๋‚˜, ์—†๋Š” ํ‚ค๋ฅผ ์ž„์˜๋กœ ๋งŒ๋“ค๊ณ , ๋ฉ”์‹œ์ง€ ๋ฌธ๋ฒ•์„ ํ˜ผ๋™ํ•˜๊ณค ํ•ฉ๋‹ˆ๋‹ค. ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ์—์ด์ „ํŠธ๊ฐ€ ์ฝ˜ํ…์ธ ๋ฅผ ์กฐํšŒ, ์ฑ„์šฐ๊ธฐ(fill), ํ…Œ์ŠคํŠธํ•  ์ˆ˜ ์žˆ๋Š” Agent Skills๋‚˜ MCP ์„œ๋ฒ„๋ฅผ ์ œ๊ณตํ•˜๋‚˜์š”? ๋˜ํ•œ ์ฝ˜ํ…์ธ  ๋กœ๋”ฉ์ด ๊ธฐ๋ณธ์ ์œผ๋กœ ์ตœ์ ํ™”๋˜์–ด ์žˆ๋Š”์ง€, ์•„๋‹ˆ๋ฉด ๋ถ„๊ธฐ๋งˆ๋‹ค ๋„ค์ž„์ŠคํŽ˜์ด์Šค์™€ lazy import๋ฅผ ์ˆ˜๋™์œผ๋กœ ๊ฒ€ํ† ํ•ด์•ผ ํ•˜๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”.

    ๊ธฐ๋ณธ์œผ๋กœ ์ œ๊ณต๋˜๋Š” ํƒ€์ž… ์•ˆ์ „์„ฑ.

    "์ถ”๊ฐ€ ์„ค์ •์„ ํ†ตํ•ด ํƒ€์ž…์„ ์ง€์ •ํ•  ์ˆ˜ ์žˆ์Œ"์ด ์•„๋‹ˆ๋ผ "์ƒˆ๋กœ ์„ค์น˜ํ•˜์ž๋งˆ์ž ์ž˜๋ชป๋œ ํ‚ค๋ฅผ ์‚ฌ์šฉํ•˜๋ฉด tsc๊ฐ€ ์‹คํŒจํ•จ"์„ ์˜๋ฏธํ•ฉ๋‹ˆ๋‹ค. ์กด์žฌํ•˜์ง€ ์•Š๋Š” ํ‚ค๋ฅผ ์‚ฌ์šฉํ•  ๋•Œ์™€ ํŠน์ • ๋กœ์ผ€์ผ์— ๋ฒˆ์—ญ์ด ํ•˜๋‚˜ ๋ˆ„๋ฝ๋˜์—ˆ์„ ๋•Œ ์–ด๋–ค ์ผ์ด ๋ฐœ์ƒํ•˜๋Š”์ง€ ํ™•์ธํ•ด ๋ณด์„ธ์š”.

    ๋ฏธ์‚ฌ์šฉ ์ฝ˜ํ…์ธ  ๊ฐ์ง€.

    ์นดํƒˆ๋กœ๊ทธ๋Š” ์‹œ๊ฐ„์ด ์ง€๋‚จ์— ๋”ฐ๋ผ ๋Š˜์–ด๋‚˜๊ธฐ๋งŒ ํ•ฉ๋‹ˆ๋‹ค. Intlayer ๋นŒ๋“œ๋Š” ์‚ฌ์šฉ๋˜์ง€ ์•Š๋Š” ํ•„๋“œ๋ฅผ ์ œ๊ฑฐํ•˜๊ณ  ๋กœ๊ทธ๋ฅผ ๋‚จ๊น๋‹ˆ๋‹ค(build.purge). Paraglide๋Š” ํ˜ธ์ถœ๋˜์ง€ ์•Š์€ ๋ฉ”์‹œ์ง€ ํ•จ์ˆ˜๊ฐ€ ํŠธ๋ฆฌ ์‰์ดํ‚น๋˜๋ฏ€๋กœ ์•„ํ‚คํ…์ฒ˜์ ์œผ๋กœ ์ด๋ฅผ ํ•ด๊ฒฐํ•ฉ๋‹ˆ๋‹ค. ๊ทธ ์™ธ์˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ๋ฏธ์‚ฌ์šฉ ํ‚ค ์ •๋ฆฌ๋ฅผ ์ „์ ์œผ๋กœ ๊ฐœ๋ฐœ์ž์—๊ฒŒ ๋งก๊น๋‹ˆ๋‹ค.

    ๊ฐœ๋ฐœ์ž ๊ฒฝํ—˜ (DX).

    ์ฒซ ๋ฒˆ์—ญ ๋ฌธ์ž์—ด๊นŒ์ง€์˜ ์„ค์ • ์‹œ๊ฐ„, ๋งˆ์šฐ์Šค ํ˜ธ๋ฒ„ ์‹œ ๋ฒˆ์—ญ์„ ๋ฏธ๋ฆฌ ๋ณด์—ฌ์ฃผ๊ณ  ์„ ์–ธ ์œ„์น˜๋กœ ๋ฐ”๋กœ ์ด๋™ํ•  ์ˆ˜ ์žˆ๋Š” LSP ๋˜๋Š” VS Code ํ™•์žฅ ํ”„๋กœ๊ทธ๋žจ, fill, test, push๋ฅผ ์ง€์›ํ•˜๋Š” CLI, ์ปดํฌ๋„ŒํŠธ์— ํ•˜๋“œ์ฝ”๋”ฉ๋œ ๋ฌธ์ž์—ด์„ ์ถ”์ถœํ•ด ํ‚ค ํ•˜๋‚˜ํ•˜๋‚˜๋ฅผ ์ง์ ‘ ๊ด€๋ฆฌํ•˜์ง€ ์•Š์•„๋„ ๋˜๊ฒŒ ํ•ด์ฃผ๋Š” ์ปดํŒŒ์ผ๋Ÿฌ ๋˜๋Š” ์ถ”์ถœ๊ธฐ, ๋น„๊ฐœ๋ฐœ์ž๊ฐ€ ํ’€ ๋ฆฌํ€˜์ŠคํŠธ ์—†์ด๋„ ์ฝ˜ํ…์ธ ๋ฅผ ํŽธ์ง‘ํ•  ์ˆ˜ ์žˆ๋Š” ๋„๊ตฌ(๋น„์ฃผ์–ผ ์—๋””ํ„ฐ ๋˜๋Š” CMS)๊ฐ€ ์ œ๊ณต๋˜๋Š”์ง€ ํ™•์ธํ•˜์„ธ์š”.

    ์ž์ฃผ ๋ฌป๋Š” ์งˆ๋ฌธ (FAQ)

    ๋Œ€๋ถ€๋ถ„์˜ ํŒ€์—๊ฒŒ๋Š” ๊ทธ๋ ‡์Šต๋‹ˆ๋‹ค. ๊ฐ€์žฅ ํฐ ์ƒํƒœ๊ณ„์™€ ์˜จ๋ผ์ธ์— ๊ฐ€์žฅ ๋งŽ์€ ๋ฌธ์ œ ํ•ด๊ฒฐ ์ž๋ฃŒ๋ฅผ ๋ณด์œ ํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. ๋‹ค๋งŒ ๊ฐ€์žฅ ๋ฌด๊ฑฐ์šด ๋Ÿฐํƒ€์ž„, ๋…์ž์ ์ธ ๋ณต์ˆ˜ํ˜• ํฌ๋งท, ์ง์ ‘ ์„ค์ •ํ•˜๊ณ  ๊ด€๋ฆฌํ•ด์•ผ ํ•˜๋Š” ํƒ€์ž… ์•ˆ์ „์„ฑ ๋ฐ ์Šค์ฝ”ํ•‘ ๋“ฑ ๋ช…ํ™•ํ•˜๊ณ  ์˜ˆ์ธก ๊ฐ€๋Šฅํ•œ ํŠธ๋ ˆ์ด๋“œ์˜คํ”„๊ฐ€ ์กด์žฌํ•ฉ๋‹ˆ๋‹ค.

    ๋ฒˆ๋“ค ํฌ๊ธฐ, ์ž๋™ ์ƒ์„ฑ๋˜๋Š” ํƒ€์ž…, ๋นŒ๋“œ ํƒ€์ž„ ๋ˆ„๋ฝ ํ‚ค ๊ฒ€์‚ฌ๊ฐ€ ์š”๊ตฌ์‚ฌํ•ญ์— ํฌํ•จ๋œ ๊ฒฝ์šฐ์—๋งŒ ํ•„์š”ํ•ฉ๋‹ˆ๋‹ค. 2๊ฐœ ๋กœ์ผ€์ผ์„ ๊ฐ€์ง„ ์†Œ๊ทœ๋ชจ ์•ฑ์ด๋ผ๋ฉด ๋Ÿฐํƒ€์ž„ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๊ฐ€ ๋” ๊ฐ„๋‹จํ•ฉ๋‹ˆ๋‹ค. ์ปดํŒŒ์ผ๋Ÿฌ vs ์„ ์–ธํ˜• i18n ํฌ์ŠคํŠธ์—์„œ ์ปดํŒŒ์ผ๋Ÿฌ๊ฐ€ ์ œ๊ณตํ•˜๋Š” ์ด์ ๊ณผ ์ฃผ์˜ํ•  ์ ์„ ์„ค๋ช…ํ•ฉ๋‹ˆ๋‹ค.

    ๋ถ€๋ถ„์ ์œผ๋กœ ๊ฐ€๋Šฅํ•ฉ๋‹ˆ๋‹ค. ํ‚ค ๊ธฐ๋ฐ˜ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋“ค์€ ์œ ์‚ฌํ•œ ๊ตฌ์กฐ๋ฅผ ๊ณต์œ ํ•˜๋ฏ€๋กœ ํ˜ธํ™˜ ์–ด๋Œ‘ํ„ฐ๋ฅผ ํ†ตํ•ด ํ•˜๋‚˜์˜ API๋ฅผ ๋‹ค๋ฅธ API๋กœ ๋ณ„์นญ(alias) ์ฒ˜๋ฆฌํ•  ์ˆ˜ ์žˆ์œผ๋ฉฐ, ์ด๊ฒƒ์ด Intlayer ์–ด๋Œ‘ํ„ฐ์˜ ์ž‘๋™ ๋ฐฉ์‹์ž…๋‹ˆ๋‹ค. ๋‹ค๋งŒ ๋ฉ”์‹œ์ง€ ํฌ๋งท(ICU vs i18next vs ํ—ฌํผ)์€ ์ž๋™์œผ๋กœ ๋ณ€ํ™˜๋˜์ง€ ์•Š์œผ๋ฏ€๋กœ ๋ณต์ˆ˜ํ˜•์ด๋‚˜ ๋ณด๊ฐ„(interpolation) ๋ถ€๋ถ„์€ ์ง์ ‘ ์ˆ˜์ •ํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค.

    ๊ฐ„์ ‘์ ์œผ๋กœ ์˜ํ–ฅ์„ ๋ฏธ์นฉ๋‹ˆ๋‹ค. ํฌ๋กค๋Ÿฌ๊ฐ€ ๋ณด๋Š” ๋‚ด์šฉ์€ ๋ผ์šฐํŒ…, hreflang, <html lang> ์„ค์ •, ๊ทธ๋ฆฌ๊ณ  ํ…์ŠคํŠธ๊ฐ€ ์„œ๋ฒ„ ๋ Œ๋”๋ง๋œ HTML์— ํฌํ•จ๋˜๋Š”์ง€์— ๋”ฐ๋ผ ๊ฒฐ์ •๋ฉ๋‹ˆ๋‹ค. ์ผ๋ถ€ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ๋Š” ์ด๋ฅผ ๋•๋Š” ํ—ฌํผ๋ฅผ ์ œ๊ณตํ•˜์ง€๋งŒ ๋Œ€๋ถ€๋ถ„์€ ๊ฐœ๋ฐœ์ž๊ฐ€ ์ง์ ‘ ์ฒ˜๋ฆฌํ•ด์•ผ ํ•ฉ๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ hreflang ๊ฐ€์ด๋“œ๋ฅผ ์ฐธ๊ณ ํ•˜์„ธ์š”.

    ๋” ์•Œ์•„๋ณด๊ธฐ

    ๋Œ“๊ธ€

    ์•„์ง ๋Œ“๊ธ€์ด ์—†์Šต๋‹ˆ๋‹ค. ์ฒซ ๋ฒˆ์งธ๋กœ ์˜๊ฒฌ์„ ๋‚˜๋ˆ ๋ณด์„ธ์š”.

    ๊ด€๋ จ ๊ฒŒ์‹œ๋ฌผ

    ์ตœ๊ทผ ๊ฒŒ์‹œ๋ฌผ