@intlayer/docs 9.5.2 → 9.5.4-canary.0

package/blog/ko/vue-i18n_vs_intlayer-vue-i18n.md

@@ -0,0 +1,288 @@
+---
+createdAt: 2026-09-13
+updatedAt: 2026-09-13
+title: "vue-i18n vs @intlayer/vue-i18n: 동일한 API, 다른 Bundle"
+description: Vue 3 앱이 vue-i18n 호출을 유지하면서 @intlayer/vue-i18n compat adapter를 통해 제공할 때 어떤 변화가 발생하는지 알아봅니다. 동일한 Vite + Vue 코드에서 페이지별 JavaScript, runtime 크기, 컴포넌트 크기 및 누수를 측정하고, adapter가 유지하는 것, 무시하는 것, 그리고 대체할 수 없는 것을 비교합니다.
+keywords:
+  - vue-i18n
+  - "@intlayer/vue-i18n"
+  - Intlayer
+  - Compat adapter
+  - Migration
+  - Internationalization
+  - i18n
+  - Benchmark
+  - Bundle size
+  - Blog
+  - Vue
+  - Nuxt
+  - Vite
+slugs:
+  - blog
+  - vue-i18n-vs-intlayer-vue-i18n
+author: aymericzip
+---
+
+# vue-i18n VS @intlayer/vue-i18n | 동일한 API, 다른 Bundle
+
+`@intlayer/vue-i18n`은 compat 어댑터입니다: `vue-i18n` API (`createI18n`, `useI18n`, `t()`, `d()`, `n()`, `$t`, `v-t`, `i18n.global.locale`...)를 노출하고 Intlayer에 의해 컴파일된 딕셔너리에서 제공합니다. 당신의 `.vue` 파일은 변경되지 않습니다. `t("footer.github")`가 바인딩되는 대상만 변경됩니다.
+
+이 문서는 동일한 Vite + Vue 3 애플리케이션에서 `vue-i18n`으로 빌드한 경우와 어댑터로 빌드한 경우의 성능 변화를 측정합니다. 수치는 [Benchmark Bloom](https://github.com/intlayer-org/benchmark-bloom)에서 나왔습니다. `vue-i18n`과 Intlayer를 라이브러리로 비교하려면 [vue-i18n vs Intlayer](https://intlayer.org/blog/vue-i18n-vs-intlayer)와 [vue-i18n vs Intlayer benchmark](https://intlayer.org/blog/vue-i18n-vs-intlayer-benchmark)를 읽으세요. 이 문서는 컴포넌트를 그대로 유지했을 때 어댑터가 어떤 변화를 가져오는지에 관한 것입니다.
+
+<TOC/>
+
+> **tl;dr**: 동일한 Vite + Vue 3 앱에서 `vue-i18n`을 `@intlayer/vue-i18n`으로 교체하면 페이지당 JavaScript가 **134.9 KB에서 47.0 KB** gzip으로 감소했습니다 (i18n 없는 앱의 무게는 41.3 KB), 런타임은 **24.3 KB에서 7.9 KB**, 평균 컴포넌트는 **196 KB에서 8.4 KB**, 외부 페이지 문자열 누수는 **90%에서 0%**로 감소했습니다. 단 하나의 `.vue` 파일도 수정하지 않았습니다. `createI18n({ messages })`는 폴백으로 계속 작동합니다. JSON imports를 제거하면 위의 숫자를 얻을 수 있습니다. SFC `<i18n>` 블록과 런타임 `setLocaleMessage()`는 이월되지 않는 두 가지 기능입니다.
+
+## `@intlayer/vue-i18n`이란 무엇인가
+
+`vue-i18n`는 런타임입니다. `createI18n({ messages: { en, fr, ... } })`는 모든 로케일의 모든 메시지를 보유하는 글로벌 인스턴스를 빌드합니다. `useI18n()`은 각 컴포넌트를 이에 바인딩하고, `t("footer.github")`는 렌더 시간에 트리를 순회합니다. 이 디자인은 SFC `<i18n>` 블록과 `setLocaleMessage()`를 가능하게 하는 것이며, 모든 컴포넌트의 의존성 그래프가 전체 트리를 포함하는 이유이기도 합니다.
+
+`@intlayer/vue-i18n`는 API를 유지하고 트리를 대체합니다:
+
+1. **Import aliasing.** `@intlayer/vue-i18n/plugin`의 `vueI18nVitePlugin()`은 `vite-intlayer`를 래핑하고 `vue-i18n`이 `@intlayer/vue-i18n`으로 해석되도록 하는 `resolve.alias`를 추가합니다. import는 이름이 바뀌지 않습니다.
+2. **JSON as source of truth.** `syncJSON` plugin는 기존 `locales/{locale}.json`을 `format: "vue-i18n"`으로 읽으며 (`{name}`, `{0}` list interpolation과 `"car | cars"` pipe plurals이 올바르게 파싱됨), CLI 또는 CMS가 이들을 업데이트할 때 번역을 다시 작성합니다.
+3. **Call-site binding.** Intlayer optimize pass는 `useI18n()` call sites를 다시 작성하여 component가 활성 locale에서 키 이름의 dictionaries를 받고, bundler가 추적하고 분할할 수 있는 imports를 받습니다.
+
+```vue fileName="src/components/Footer.vue"
+<!-- Your code, unchanged -->
+<script setup lang="ts">
+import { useI18n } from "vue-i18n";
+
+const { t } = useI18n();
+</script>
+
+<template>
+  <a href="https://github.com/intlayer-org/benchmark-bloom">{{
+    t("footer.github")
+  }}</a>
+</template>
+```
+
+```ts fileName="컴파일러가 생성하는 것 (간소화됨)"
+import _dicHash_footer from "../.intlayer/dictionaries/footer.mjs";
+import { useDictionary as useI18n } from "@intlayer/vue-i18n";
+
+const { t } = useI18n(_dicHash_footer);
+```
+
+컴포넌트가 더 이상 전역 메시지 트리에 접근하지 않습니다. `footer`에만 접근합니다. 이것이 아래 component-size 열이 196 KB에서 8 KB로 떨어지는 이유입니다.
+
+## 어댑터가 유지하는 것, 무시하는 것, 그리고 대체하지 않는 것
+
+| `vue-i18n` API                                                      | `@intlayer/vue-i18n`을 사용할 때                                                                                         |
+| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
+| `useI18n()` → `{ t, d, n, te, tm, rt, locale, availableLocales }`   | ✅ 유지됨. `t` 키는 당신의 딕셔너리에 대해 타입이 지정됨                                                                 |
+| `t("key", { name })`, `t("key", [a, b])`, `t("key", count)`         | ✅ 유지됨. `{name}`, `{0}` 및 파이프로 구분된 복수형은 이전과 같이 해결됨                                                |
+| `d(date, "long")`, `n(value, "currency")`                           | ✅ 유지됨. `createI18n()`의 `datetimeFormats` / `numberFormats`은 준수되며, 기본 `Intl`로 지원됨                         |
+| `i18n.global.locale.value = "fr"`                                   | ✅ 유지됨. Intlayer의 클라이언트에서 지원하는 `WritableComputedRef`이며, 반응성은 이전과 동일하게 동작함                 |
+| `$t`, `$tc`, `$te`, `$tm`, `$rt`, `$d`, `$n`, `$i18n` (Options API) | ✅ 유지됨. `app.use(i18n)`에 의해 `app.config.globalProperties`에 등록됨                                                 |
+| `v-t` directive                                                     | ✅ 유지됨                                                                                                                |
+| `legacy: true`                                                      | ✅ 허용됨                                                                                                                |
+| `createI18n({ messages })`                                          | ⚠️ `messages`는 **runtime fallback**으로 사용되며 개발 경고가 표시됩니다. 번들 크기 감소를 위해 JSON import를 제거하세요 |
+| `setLocaleMessage()`, `mergeLocaleMessage()`                        | ❌ 경고 표시 후 작동하지 않음. Runtime message 로딩은 build-time dictionaries로 대체됩니다                               |
+| SFC `<i18n>` custom blocks                                          | ❌ 읽지 않음. 이 메시지들을 locale JSON으로 이동하거나 component 옆의 `.content.ts`로 옮기세요                           |
+| `@nuxtjs/i18n`                                                      | ⚠️ 별도의 adapter, [Nuxt compat doc](https://intlayer.org/doc/compatibility/nuxtjs-i18n)을 참조하세요                    |
+
+## 벤치마크
+
+### 측정 항목
+
+[Benchmark Bloom](https://github.com/intlayer-org/benchmark-bloom) 스위트는 각 설정으로 **동일한 Vite + Vue 3 애플리케이션**을 빌드합니다: **10개 페이지** (home, about, blog, careers, contact, FAQ, pricing, products, settings, team), **10개 로케일** (`en`, `fr`, `es`, `de`, `it`, `pt`, `zh`, `ja`, `ko`, `ru`), 동일한 컴포넌트와 동일한 콘텐츠. 페이지는 `en` 및 `fr`로 측정됩니다.
+
+둘 다 **static** 구성으로 빌드되었습니다. 대부분의 Vue 프로젝트가 배포하는 구성입니다: `vue-i18n`의 경우, 모든 로케일의 JSON이 import되어 `createI18n({ messages })`로 전달됩니다; 어댑터의 경우, `vite.config.ts` 및 `intlayer.config.ts`가 변경되고 `messages` import가 제거된 동일한 컴포넌트입니다. 참고용으로 native `vue-intlayer`가 포함되어 있습니다.
+
+각 빌드에 대해 스위트는 다음을 기록합니다:
+
+- **Lib size**: i18n 라이브러리만 import하는 빈 컴포넌트의 gzip (및 minified) 크기.
+- **Page JS**: 모든 페이지와 로케일에 걸쳐 평균화된 페이지당 다운로드되는 gzip JavaScript 크기.
+- **Locale leak %**: 사용자가 **보고 있지 않은** 로케일에 속하는 다운로드된 JS의 번역된 문자열 비율.
+- **Page leak %**: 사용자가 **있지 않은** 페이지에 속하는 다운로드된 JS의 번역된 문자열 비율.
+- **Component avg**: 격리된 상태로 컴파일된 각 컴포넌트의 평균 gzip 크기.
+- **E2E reactivity**: 새로운 로케일을 선택한 후 `html[lang]`이 DOM에서 업데이트될 때까지의 실제 소요 시간 (Playwright, 5회 반복).
+- **Page load**: `PerformanceNavigationTiming.duration`.
+
+> 아래 숫자들은 **2026-09-12** 실행 날짜의 `vue-i18n` 11.4.0과 `@intlayer/vue-i18n` 9.5.1을 사용한 결과입니다. 테스트 애플리케이션은 의도적으로 작은 규모(로케일당 수십 개의 문자열)이므로, leakage 백분율은 **패턴**을 설명합니다: 콘텐츠가 증가하면서 leakage는 증가하지만 런타임 비용은 고정된 상태로 유지됩니다.
+
+### Vite + Vue 3 결과
+
+| Setup                    | Strategy | Lib size (gz) | Lib size (min) | Page JS avg (gz) | Locale leak | Page leak | Component avg (gz) | E2E reactivity |  Page load |
+| ------------------------ | -------- | ------------: | -------------: | ---------------: | ----------: | --------: | -----------------: | -------------: | ---------: |
+| **base** (i18n 없음)     | -        |        0.0 KB |         0.0 KB |          41.3 KB |        0.0% |         - |             1.1 KB |         1.8 ms |    10.8 ms |
+| `vue-i18n`               | static   |       24.3 KB |        83.2 KB |         134.9 KB |       50.0% |     90.0% |           196.0 KB |         2.8 ms |    13.6 ms |
+| **`@intlayer/vue-i18n`** | static   |    **7.9 KB** |    **23.2 KB** |      **47.0 KB** |   **15.0%** |  **0.0%** |         **8.4 KB** |     **1.5 ms** | **9.3 ms** |
+| `vue-intlayer` (native)  | static   |        3.9 KB |        11.1 KB |          57.1 KB |       56.8% |      0.0% |             7.7 KB |         4.5 ms |    13.8 ms |
+| `vue-intlayer` (native)  | dynamic  |        3.9 KB |        11.1 KB |          59.8 KB |       50.0% |      0.0% |             6.5 KB |         4.0 ms |    15.8 ms |
+
+> base app의 page-leak 열은 공백으로 남겨집니다: i18n 라이브러리가 없으면 fingerprinting이 shared chunks의 하드코딩된 문자열을 선택하고 숫자는 의미가 없습니다.
+
+**읽는 방법**
+
+- **페이지당 88 KB 절감, 동일한 components.** `vue-i18n`은 41.3 KB app을 **134.9 KB**로 가져갑니다. 동일한 components의 adapter 빌드는 **47.0 KB**에 도달하며, base app보다 5.7 KB 초과합니다. 차이의 대부분은 `createI18n({ messages })`가 모든 페이지로 끌어오는 74.9 KB의 `src/locales`이고 adapter는 절대 블록으로 번들하지 않습니다.
+- **런타임이 3배 축소됩니다.** `vue-i18n`만 import하는 빈 component의 비용은 **24.3 KB gzip / 83.2 KB minified**입니다: `@intlify/core-base`, message compiler 및 runtime. Adapter의 비용은 **7.9 KB / 23.2 KB**이며, 대부분 Intlayer의 core와 `vue-i18n` API surface입니다.
+- **Components: 23배 더 작습니다.** 격리 상태로 컴파일된 `useI18n()` component의 평균 크기는 **196 KB**입니다. 왜냐하면 `t`는 모든 locale의 모든 message를 보유하는 instance에 바인딩되기 때문입니다. Adapter를 사용하면 동일한 component의 평균 크기는 **8.4 KB**입니다: 자신의 dictionary에 도달합니다.
+- **누수(Leakage).** `vue-i18n`은 모든 로캘과 모든 페이지의 문자열을 모든 페이지에 제공합니다: 50% 로캘 누수 (두 개의 fingerprinted 로캘에서; 10개의 로캘이 번들된 경우 실제 낭비는 더 높음), 90% 페이지 누수. 어댑터는 각 컴포넌트가 자신의 딕셔너리만 import하기 때문에 페이지 누수를 **0%**로 줄입니다. 이 `static` 실행에서 로캘 누수는 15%입니다; `importMode: 'dynamic'`은 이를 제거하는 설정이며, 이 Vue 실행에는 해당 설정이 포함되지 않았습니다.
+- **반응성 및 페이지 로드.** 로캘 전환은 두 경우 모두 저렴합니다 (1.5-2.8 ms); 메시지가 메모리에 있으면 Vue의 반응성 시스템이 이를 가능하게 합니다. 페이지 로드는 13.6 ms에서 **9.3 ms**로 단축되며, 이는 파싱할 JavaScript가 88 KB 줄어든 것과 일치합니다.
+- **네이티브 행에 대해.** `vue-intlayer`는 이 실행에서 `static` 모드에서 모든 로케일을 번들링했으며 3.9 KB 런타임과 함께 57.1 KB에 도달했습니다. 어댑터의 동기화된 딕셔너리는 더 적은 외국 로케일 문자열을 포함했으므로 페이지당 수치가 더 낮습니다. 네이티브 런타임은 세 개 중 가장 가볍게 유지되며, 해당 `.content.ts` 모델은 SFC `<i18n>` 블록이 동등한 것을 찾는 곳입니다.
+
+## 숫자가 움직이는 이유
+
+`src/components/`의 아무것도 변경되지 않았으므로 이득은 `useI18n`이 바인딩된 대상에서 나옵니다.
+
+**`vue-i18n`을 사용할 때**, 바인딩은 글로벌 인스턴스입니다. `createI18n({ messages: { en, fr, ... } })`은 모든 것을 포함하는 하나의 import이고, `useI18n()`을 호출하는 모든 컴포넌트가 모든 콘텐츠에 접근할 수 있으므로 번들러는 인스턴스 아래로 분할할 수 없습니다. 최적화는 _직접_ `en.json`을 라우트별로 분할하고, 라우터 가드에서 `setLocaleMessage()`를 호출하며, 컴포넌트가 이동할 때 라우트-파일 매핑을 올바르게 유지하는 것을 의미합니다.
+
+```bash
+.
+├── locales
+│   ├── en.json                    # 모든 페이지의 문자열
+│   └── fr.json
+└── src
+    ├── i18n.ts                    # createI18n({ messages: { en, fr, ... } })
+    ├── main.ts                    # app.use(i18n)
+    └── components
+        └── Footer.vue             # useI18n(); t("footer.github")
+```
+
+**`@intlayer/vue-i18n`을 사용할 때**, 바인딩은 dictionary입니다. `syncJSON`은 `en.json`의 각 top-level 키를 dictionary로 변환합니다. optimize pass는 component에 해당 키의 항목들을 제공하고, bundler가 추적하여 페이지별로 split합니다.
+
+```bash
+.
+├── intlayer.config.ts             # syncJSON({ format: "vue-i18n", source: ... })
+├── locales
+│   ├── en.json                    # unchanged, still the source of truth
+│   └── fr.json
+├── .intlayer/                     # generated: one dictionary per top-level key, per locale
+└── src
+    ├── i18n.ts                    # createI18n({})   ← messages import 제거됨
+    ├── main.ts                    # app.use(i18n)    ← unchanged
+    └── components
+        └── Footer.vue             # useI18n(); t("footer.github")  ← unchanged
+```
+
+`i18n.ts`의 `messages` import는 삭제해야 할 한 줄입니다. 이것이 88 KB입니다.
+
+## 세 단계로 마이그레이션
+
+<Steps>
+<Step number={1} title="설치">
+
+```bash packageManager="npm"
+npx intlayer init --interactive
+```
+
+```bash packageManager="pnpm"
+pnpm dlx intlayer init --interactive
+```
+
+```bash packageManager="yarn"
+yarn dlx intlayer init --interactive
+```
+
+```bash packageManager="bun"
+bunx intlayer init --interactive
+```
+
+명령어는 `vue-i18n`을 감지하고, `intlayer`, `vue-intlayer`, `@intlayer/vue-i18n` 및 `@intlayer/sync-json-plugin`을 설치하며, `intlayer.config.ts`를 미리 채웁니다. `vue-i18n`을 설치된 상태로 유지하세요: 이는 peer dependency이며 타입을 제공합니다.
+
+</Step>
+<Step number={2} title="Intlayer를 locale 파일로 지정">
+
+```ts fileName="intlayer.config.ts"
+import { Locales, type IntlayerConfig } from "intlayer";
+import { syncJSON } from "@intlayer/sync-json-plugin";
+
+const config: IntlayerConfig = {
+  internationalization: {
+    locales: [Locales.ENGLISH, Locales.FRENCH, Locales.SPANISH],
+    defaultLocale: Locales.ENGLISH,
+  },
+  dictionary: {
+    // "static"은 모든 로케일을 번들링합니다; "dynamic"은 활성 로케일을 필요에 따라 로드합니다
+    importMode: "dynamic",
+    format: "vue-i18n",
+  },
+  plugins: [
+    syncJSON({
+      // vue-i18n 방언: {name}, {0}, "car | cars"
+      format: "vue-i18n",
+      source: ({ locale }) => `./locales/${locale}.json`,
+      location: "locales",
+    }),
+  ],
+};
+
+export default config;
+```
+
+`locales/{locale}.json`은 원래 위치에 유지됩니다. 각 최상위 키(`footer`, `hero`...)는 dictionary가 됩니다.
+
+</Step>
+<Step number={3} title="플러그인 추가 및 메시지 import 제거">
+
+```ts fileName="vite.config.ts"
+import { defineConfig } from "vite";
+import vue from "@vitejs/plugin-vue";
+import { vueI18nVitePlugin } from "@intlayer/vue-i18n/plugin";
+
+export default defineConfig({
+  plugins: [vue(), vueI18nVitePlugin()],
+});
+```
+
+```ts fileName="src/i18n.ts"
+import { createI18n } from "vue-i18n";
+
+// Before: createI18n({ locale: "en", messages: { en, fr, es } })
+export const i18n = createI18n({ locale: "en" });
+```
+
+`vueI18nVitePlugin()`은 `vite-intlayer`를 감싸고 (콘텐츠 감시, dictionary 컴파일, optimize pass) `vue-i18n`을 adapter로 aliasing합니다. `messages` import를 제거하는 것이 88 KB를 줄일 수 있습니다; 남겨두면 앱이 계속 작동하지만 둘 다 배포됩니다.
+
+</Step>
+</Steps>
+
+### 나중에 삭제할 수 있는 것
+
+| 파일 / 패턴                                       | 이유                                                             |
+| ------------------------------------------------- | ---------------------------------------------------------------- |
+| `import en from "./locales/en.json"` 및 유사 항목 | adapter의 fallback으로만 사용됨. 88 KB가 여기에 있었음           |
+| 라우터 가드의 `setLocaleMessage()`                | No-op. 라우트별 로딩은 이제 compiler의 역할임                    |
+| `@intlify/unplugin-vue-i18n`                      | 필요 없음: 메시지를 미리 컴파일하고 adapter가 읽지 않는 SFC 블록 |
+| SFC `<i18n>` 블록                                 | 읽지 않음; locale JSON 또는 컴포넌트당 `.content.ts`로 이동      |
+
+### 바이트 절감 외에 얻을 수 있는 것
+
+- **타입화된 키.** `t("footer.github")`는 컴파일된 `footer` 딕셔너리에 대해 타입이 지정되며, 잘못된 경로는 키가 텍스트로 렌더링되는 대신 TypeScript 오류가 됩니다.
+- **`npx intlayer test`** 는 모든 locale에서 누락된 키가 있으면 CI를 실패시킵니다. **`npx intlayer fill`** 은 자신의 provider 키(OpenAI, Anthropic, Mistral, Gemini...)로 누락된 키를 번역하고 `locales/{locale}.json`에 다시 작성합니다.
+- **Visual Editor 및 CMS** 는 동일한 JSON에서 작동하므로 개발자가 아닌 사람은 UI를 통해 편집하고 파일이 업데이트됩니다.
+- **`.content.ts`로의 점진적 이동.** 모든 컴포넌트는 `useI18n()`에서 `useIntlayer("footer")`로 전환할 수 있으며, 함께 배치된 콘텐츠 파일을 사용합니다. JSON 및 `.content.ts` 딕셔너리는 공존하며 병합됩니다.
+
+## 시작하기 전에 알아야 할 제한사항
+
+- **SFC `<i18n>` 블록은 읽히지 않습니다.** 메시지가 컴포넌트 내부에 있는 경우, 로케일 파일로 이동해야 합니다 (또는 타입이 있는 `.content.ts`로, 이는 같은 개념입니다).
+- **런타임 메시지 로딩이 제거되었습니다.** `setLocaleMessage()`와 `mergeLocaleMessage()`는 경고를 표시하고 반환합니다. 런타임에 CMS에서 가져온 번역은 Intlayer의 CMS를 사용하거나 `intlayer pull` / `push` 명령이 필요합니다.
+- **`messages`는 대체 수단일 뿐, 무료가 아닙니다.** `createI18n()`에서 JSON import를 유지하면 번들에 75 KB가 남습니다. `intlayer test`가 통과하면 삭제하세요.
+- **adapter는 native runtime이 아닙니다.** `vue-intlayer`의 3.9 KB에 비해 7.9 KB입니다. 모든 component가 `useIntlayer`로 이동하면 제거하세요.
+
+## 어떤 것을 언제 사용할까요?
+
+- **`vue-i18n`에 머물러있으세요** 앱이 SFC `<i18n>` 블록, runtime `setLocaleMessage()` 흐름에 의존하거나 페이지당 90 KB가 사용자에게 문제가 되지 않는 경우.
+- **`@intlayer/vue-i18n`을 사용하세요** `vue-i18n`을 사용 중이고 88 KB, 23배 더 작은 component, 0% page leakage, typed keys 및 `.vue` 파일을 수정하지 않고도 CI checks를 원하는 경우. 이것은 기존 `vue-i18n` codebase의 진입점입니다.
+- **native(`vue-intlayer`)로 이동하세요** 새로운 프로젝트이거나 adapter가 작업을 완료한 후. 가장 가벼운 runtime(3.9 KB)과 `<i18n>` 블록을 typed content로 대체하는 per-component `.content.ts` 모델이 있습니다.
+
+## 관련 비교
+
+- [vue-i18n vs Intlayer](https://intlayer.org/blog/vue-i18n-vs-intlayer) (기능 및 DX)
+- [vue-i18n vs Intlayer 벤치마크](https://intlayer.org/blog/vue-i18n-vs-intlayer-benchmark) (라이브러리, 동일한 벤치마크)
+- [next-intl vs @intlayer/next-intl](https://intlayer.org/blog/next-intl-vs-intlayer-next-intl) (동일한 어댑터 시리즈)
+- [i18next vs @intlayer/i18next](https://intlayer.org/blog/i18next-vs-intlayer-i18next) (동일한 어댑터 시리즈)
+- [Lingui vs @intlayer/lingui](https://intlayer.org/blog/lingui-vs-intlayer-lingui) (동일한 어댑터 시리즈)
+- [마이그레이션 가이드: vue-i18n에서 Intlayer로](https://intlayer.org/doc/migration/vue-i18n)
+- [Compat adapter reference: vue-i18n](https://intlayer.org/doc/compatibility/vue-i18n), [Nuxt i18n](https://intlayer.org/doc/compatibility/nuxtjs-i18n)
+
+## 결론
+
+`@intlayer/vue-i18n`은 `useI18n()`이 바인딩되는 대상을 변경합니다: 모든 locale의 모든 message를 보유하는 global instance에서 해당 component를 위해 컴파일된 dictionary로. 동일한 Vite + Vue 3 app에서 **page당 88 KB 감소**, **3배 작은 runtime**, **23배 작은 components** 및 **0% page leakage**를 달성할 수 있으며, config 파일 하나, plugin line 하나, 그리고 삭제된 import 하나만 필요합니다. SFC `<i18n>` blocks과 runtime message loading은 지원하지 않는 두 가지이며, native `vue-intlayer` runtime은 여전히 그 절반 크기입니다.
+
+모든 원본 데이터, 테스트 앱 및 스크립트는 [Benchmark Bloom 저장소](https://github.com/intlayer-org/benchmark-bloom)에 있습니다. 직접 실행해보세요.
+
+자세한 내용은 ['Intlayer를 선택해야 하는 이유?' 문서](https://intlayer.org/doc/why)를 참조하세요.

package/blog/ko/vue-i18n_vs_intlayer.md

@@ -235,7 +235,7 @@ const { greeting } = useIntlayer("component-example");
 
 GitHub stars는 프로젝트의 인기도, 커뮤니티 신뢰도, 장기적 관련성의 강력한 지표입니다. 기술적 품질을 직접 측정하는 것은 아니지만, 얼마나 많은 개발자들이 프로젝트를 유용하게 생각하고, 진행 상황을 따르고 있으며, 채택할 가능성이 있는지를 반영합니다. 프로젝트의 가치를 추정하기 위해 stars는 대안들 간의 견인력을 비교하고 생태계 성장에 대한 통찰력을 제공합니다.
 
-[![Star History Chart](https://api.star-history.com/svg?repos=intlify/vue-i18n&repos=aymericzip/intlayer&type=Date)](https://www.star-history.com/#intlify/vue-i18n&aymericzip/intlayer)
+[![Star History Chart](https://api.star-history.com/svg?repos=intlify/vue-i18n&repos=aymericzip/intlayer&type=Date)](https://star-history.com/#intlify/vue-i18n&aymericzip/intlayer)
 
 ## 결론