Спросите свой вопрос и получите сводку документа, используя эту страницу и выбранного вами поставщика AI
Содержимое этой страницы было переведено с помощью ИИ.
Смотреть последнюю версию оригинального контента на английскомЕсли у вас есть идея по улучшению этой документации, не стесняйтесь внести свой вклад, подав запрос на вытягивание на GitHub.
Ссылка на документацию GitHubКопировать Markdown документа в буфер обмена
vue-i18n VS Intlayer: Бенчмарк интернационализации (i18n) для Vue
vue-i18n, эталонная i18n-библиотека для Vue. Intlayer, альтернатива на основе компилятора с контентом, ограниченным областью компонента, и интеграцией с Vue (vue-intlayer). Эта статья рассматривает, во что обходится каждая из них после сборки приложения.
Данные взяты из Benchmark Bloom, open-source набора, который собирает одно и то же приложение с каждой библиотекой и записывает, что браузер на самом деле загружает и выполняет.
tl;dr: На одном и том же приложении Vite + Vue 3vue-i18nотдаёт 134,9 КБ gzip-сжатого JavaScript на страницу против 41,3 КБ для приложения без i18n. Intlayer отдаёт 57,1 КБ. Один только рантаймvue-i18nвесит 24,3 КБ gzip (в 6 раз больше 3,9 КБ у Intlayer), каждая страница несёт 90 % строк чужих страниц, а компонент, скомпилированный изолированно, тянет за собой 196 КБ, потому что привязан к глобальному дереву сообщений. Адаптер@intlayer/vue-i18nсохраняет APIvue-i18nи показал 47,0 КБ на страницу.
Коротко
- vue-i18n, де-факто i18n-библиотека для Vue 2 / Vue 3 и ядро
@nuxtjs/i18n. Сообщения в стиле ICU, блоки<i18n>в SFC, директиваv-t, форматтерыd()/n(), большая экосистема. Сообщения регистрируются на глобальном экземпляре вcreateI18n(); ленивая загрузка по локали, это ручной паттерн сsetLocaleMessage(), а разбиение по маршрутам вам нужно строить самостоятельно. - Intlayer, модель контента, ориентированная на компоненты. Словари
.content.tsлежат рядом с компонентом, который они обслуживают, компилятор на этапе сборки (vite-intlayer) выполняет tree-shaking и ленивую загрузку по компонентам и по локалям, строгие типы TypeScript генерируются из вашего контента, а отсутствующие переводы приводят к ошибке на этапе сборки. Включает хелперы для роутера / SEO, Visual Editor / CMS и перевод с помощью ИИ.
Открыть таблицу в модальном окне для четкого просмотра всех данных
Бейджи обновляются автоматически. Снимки будут меняться со временем.
Сравнение возможностей бок о бок
Открыть таблицу в модальном окне для четкого просмотра всех данных
| Возможность | vue-intlayer (Intlayer) | vue-i18n |
|---|---|---|
| Переводы рядом с компонентами | ✅ Да, .content.ts располагается рядом с каждым компонентом | ✅ Через блоки SFC <i18n> (опционально); обычно используются глобальные каталоги |
| Интеграция с TypeScript | ✅ Строгие типы автоматически генерируются из контента | ✅ Хорошие типы; строгая безопасность ключей требует типизации схемы и дисциплины |
| Обнаружение отсутствующих переводов | ✅ Ошибка TypeScript + ошибка/предупреждение во время сборки | ⚠️ Fallback во время выполнения + предупреждение в консоли |
| Богатый контент (компоненты / Markdown) | ✅ Прямая поддержка | ⚠️ Интерполяция компонентов <i18n-t>; Markdown через внешние плагины |
| Поддержка ICU | ⚠️ В работе | ✅ Да |
| Форматирование (даты, числа, валюты) | ✅ Форматтеры на основе Intl | ✅ d() / n() с datetimeFormats / numberFormats |
| Локализованная маршрутизация | ✅ Хелперы для Vue Router / Nuxt, getMultilingualUrls | ⚠️ Не в ядре (@nuxtjs/i18n или собственная настройка роутера) |
| SEO-хелперы (hreflang, sitemap, robots) | ✅ Встроенные хелперы | ❌ Не в ядре |
| Tree-shaking (отдавать только используемый контент) | ✅ По компонентам, по локалям, автоматически компилятором | ⚠️ Вручную: разбивать каталоги, setLocaleMessage() на каждый маршрут |
| Ленивая загрузка | ✅ importMode: 'dynamic' (одна строка конфигурации) | ✅ Ручной import() + setLocaleMessage() |
| Очистка неиспользуемого контента | ✅ Мёртвые словари удаляются на этапе сборки | ❌ Не встроено |
| Проверка отсутствующих переводов (CLI / CI) | ✅ npx intlayer content test | ⚠️ Сторонние инструменты (vue-i18n-extract) |
| Перевод с помощью ИИ | ✅ Встроен, использует ваши собственные ключи провайдера | ❌ Нет |
| Visual Editor / CMS | ✅ Бесплатный Visual Editor + опциональная CMS | ❌ Нет (внешние платформы локализации) |
| MCP-сервер и Agent Skills | ✅ Да | ❌ Нет |
| Экосистема / сообщество | ⚠️ Меньше, но быстро растёт | ✅ Большая и зрелая в экосистеме Vue |
Бенчмарк
Что измерялось
Набор 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 каждой локали импортируется и передаётся в createI18n({ messages }); для Intlayer, importMode: 'static' по умолчанию. В этом режиме Intlayer тоже упаковывает все локали, но компилятор по-прежнему ограничивает контент по компонентам, так что страница несёт только словари тех компонентов, которые она рендерит.
Для каждой сборки набор записывает:
- Lib size: gzip-размер пустого компонента, который только импортирует i18n-библиотеку. Фиксированная стоимость рантайма.
- Page JS: gzip JavaScript, загружаемый на страницу, усреднённый по всем страницам и локалям.
- Locale leak %: доля переведённых строк в загруженном JS, которые принадлежат локали, которую пользователь не просматривает (отпечатки по
enиfr, так что 50 % означает «вторая измеряемая локаль присутствует полностью»; при 10 упакованных локалях реальные потери выше). - Page leak %: доля переведённых строк в загруженном JS, которые принадлежат странице, на которой пользователь не находится.
- Component avg: средний gzip-размер каждого компонента, скомпилированного изолированно. Показывает, сколько i18n-рантайма и каталога тянет за собой один компонент.
- E2E reactivity: реальное время между выбором новой локали и обновлением
html[lang]в DOM (Playwright, 5 итераций). - Page load:
PerformanceNavigationTiming.duration.
Цифры ниже взяты из прогона от 2026-09-12 сvue-i18n11.4.0 иintlayer9.5.0 / 9.5.1. Тестовое приложение намеренно небольшое (несколько десятков строк на локаль), поэтому проценты утечки описывают закономерность: они растут вместе с вашим контентом, тогда как стоимость рантайма остаётся фиксированной.
Результаты на Vite + Vue 3
Выберите метрики и библиотеки, которые вас интересуют:
Метрика
Динамическая загрузка JSON
Ленивая загрузка переводов во время выполнения
Ограниченный JSON (пространства имен)
Пространства имен перевода для каждой страницы
Что это за метрика?
Общий размер пакета библиотеки интернационализации в формате gzip. Он включает в себя только провайдер и логику извлечения контента после tree-shaking и минификации.
Почему это важно?
Меньший размер библиотеки снижает начальную загрузку JavaScript, что ускоряет загрузку и выполнение кода на клиенте.
Вид
Открыть таблицу в модальном окне для четкого просмотра всех данных
| Библиотека | Стратегия | Lib size (gz) | Lib size (min) | Page JS ср. (gz) | Locale leak | Page leak | Component ср. (gz) | Реактивность E2E | Page load |
|---|---|---|---|---|---|---|---|---|---|
| base (без i18n) | - | 0,0 КБ | 0,0 КБ | 41,3 КБ | 0,0 % | - | 1,1 КБ | 1,8 мс | 10,8 мс |
vue-i18n | static | 24,3 КБ | 83,2 КБ | 134,9 КБ | 50,0 % | 90,0 % | 196,0 КБ | 2,8 мс | 13,6 мс |
vue-intlayer | static | 3,9 КБ | 11,1 КБ | 57,1 КБ | 56,8 % | 0,0 % | 7,7 КБ | 4,5 мс | 13,8 мс |
@intlayer/vue-i18n (compat) | static | 7,9 КБ | 23,2 КБ | 47,0 КБ | 15,0 % | 0,0 % | 8,4 КБ | 1,5 мс | 9,3 мс |
Столбец page-leak для базового приложения оставлен пустым: без i18n-библиотеки снятие отпечатков подхватывает жёстко закодированные строки в общих чанках, и число не имеет смысла.
Как это читать
- Стоимость рантайма.
vue-i18n, один из самых тяжёлых рантаймов во всём бенчмарке: 24,3 КБ gzip / 83,2 КБ в минифицированном виде для пустого компонента, который только его импортирует.vue-intlayerстоит 3,9 КБ gzip. Этот разрыв оплачивается на каждой странице независимо от того, сколько у вас строк. - JavaScript на страницу. Приложение без i18n весит 41,3 КБ.
vue-i18nувеличивает его более чем втрое, до 134,9 КБ; Intlayer выходит на 57,1 КБ, +15,8 КБ, большая часть из которых, десять упакованных локалей (см. следующий пункт). - Утечка. С
createI18n({ messages: { en, fr, ... } })каждая страница отдаёт все локали и строки всех страниц: 50 % утечки локалей (по двум измеряемым локалям) и 90 % утечки страниц. Режимstaticу Intlayer тоже упаковывает все локали (отсюда сопоставимый показатель утечки локалей), но даёт 0 % утечки страниц: страница подтягивает только словари тех компонентов, которые рендерит. Переход наimportMode: 'dynamic'убирает и утечку локалей; эта конфигурация не входила в данный прогон для Vue. - Размер компонентов, то место, где проявляется архитектура. Компонент, вызывающий
useI18n(), компилируется в среднем в 196 КБ, потому чтоt()привязан к глобальному экземпляру, который держит все сообщения всех локалей. Тот же компонент сuseIntlayer()компилируется в 7,7 КБ: он обращается только к своему словарю. - Реактивность не является проблемой ни для одной из них (2–5 мс). Система реактивности Vue делает переключение локали дешёвым, как только сообщения находятся в памяти.
@intlayer/vue-i18n, drop-in адаптер, сохраняет APIvue-i18nи показал 47,0 КБ на страницу и 8,4 КБ на компонент, при этом код приложения не изменялся.
Для справки: тот же прогон измерил fluent-vue на уровне 171,8 КБ на страницу, 29,7 КБ рантайма и 217 КБ на компонент.
Полная таблица со всеми библиотеками и всеми стратегиями в отчёте benchmark по Vue.
Откуда разрыв? Глобальный экземпляр против скомпилированных словарей
vue-i18n, это рантайм. createI18n() создаёт глобальный экземпляр, хранящий дерево сообщений для каждой локали; useI18n() привязывает к нему каждый компонент; t("footer.github") ищет ключ во время рендера. Именно это делает возможными блоки SFC <i18n>, v-t и загрузку сообщений во время выполнения, и именно поэтому граф зависимостей каждого компонента включает всё дерево:
Копировать код в буфер обмена
Оптимизация означает, что вы разбиваете en.json на файлы по маршрутам, вы вызываете setLocaleMessage() в guard роутера и вы поддерживаете корректность соответствия маршрутов файлам по мере перемещения компонентов. Рантайм не может сделать это за вас, потому что не знает, какие ключи запросит компонент.
Intlayer переносит это знание на этап сборки. Контент объявляется рядом с компонентом, а vite-intlayer определяет, какой компонент импортирует какой словарь:
Копировать код в буфер обмена
Компилятор генерирует для каждого словаря и каждой локали ровно тот JSON, который нужен этому компоненту, и отбрасывает словари, которые никто не импортирует. Ограничение по маршрутам, следствие ограничения по компонентам, а не отдельная задача.
Чтобы также отбросить неиспользуемые локали, установитеdictionary.importMode: 'dynamic'вintlayer.config.ts. См. документацию по оптимизации бандла.
Опыт разработчика
Настройка
vue-i18n
Копировать код в буфер обмена
Копировать код в буфер обмена
Intlayer
Копировать код в буфер обмена
Копировать код в буфер обмена
Копировать код в буфер обмена
Компонент
vue-i18n
Копировать код в буфер обмена
Копировать код в буфер обмена
t('counter.label') остаётся строкой, пока вы сами не типизируете схему сообщений; опечатка отрендерит ключ.
Intlayer
Копировать код в буфер обмена
Копировать код в буфер обмена
label и increment типизированы; опечатка, это ошибка TypeScript, отсутствующее французское значение, ошибка сборки.
Ленивая загрузка по локали
vue-i18n
Копировать код в буфер обмена
Затем вызовите loadLocaleMessages() из guard роутера и самостоятельно разбейте locales/{locale}.json по маршрутам, если хотите ограничение по страницам.
Intlayer
Копировать код в буфер обмена
Сохраните API vue-i18n, получите результат Intlayer
@intlayer/vue-i18n, это drop-in адаптер: useI18n(), t(), d(), n(), интерполяция {name} и {0}, множественные формы через pipe ("car | cars"), v-t и i18n.global.locale продолжают работать, но обслуживаются из словарей Intlayer, скомпилированных vite-intlayer.
Копировать код в буфер обмена
В бенчмарке compat-сборка того же приложения уменьшилась с 134,9 КБ до 47,0 КБ на страницу и с 196 КБ до 8,4 КБ на компонент, при этом компоненты не менялись. Ваши существующие locales/{locale}.json могут оставаться источником истины через плагин синхронизации JSON.
См. руководство по миграции с vue-i18n и документацию по совместимости. У пользователей Nuxt тот же путь через совместимость с @nuxtjs/i18n.
Когда что выбирать?
- Выбирайте vue-i18n, если вам нужен стандартный подход Vue, вы полагаетесь на ICU-сообщения или блоки SFC
<i18n>, уже используете@nuxtjs/i18nили платформа перевода ожидает централизованный JSON. Заложите время на разбиение каталогов и ленивую загрузку по маршрутам, если размер бандла имеет значение. - Выбирайте Intlayer, если вам нужны контент, ограниченный компонентом, строгий TypeScript, ошибки отсутствующих ключей на этапе сборки, tree-shaking и ленивая загрузка без усилий и встроенные редакторские инструменты (Visual Editor, CMS, ИИ-перевод, MCP-сервер). Особенно актуально для больших модульных кодовых баз Vue / Nuxt и дизайн-систем.
- Выбирайте
@intlayer/vue-i18n, если вы уже наvue-i18nи хотите выигрыш в размере бандла без переписывания.
Часто задаваемые вопросы
И то, и другое, в зависимости от выбранного подхода. vue-intlayer, это нативный рантайм с собственным компонуемым методом useIntlayer(). @intlayer/vue-i18n, это адаптер совместимости, сохраняющий API vue-i18n и заменяющий его привязку, что позволяет мигрировать без изменения компонентов и затем постепенно обновлять файлы.
Адаптер их не считывает. Перенесите эти сообщения в JSON-файлы локалей или в файл .content.ts рядом с компонентом, что представляет собой аналогичную идею со сгенерированными типами. Это единственная функция vue-i18n, которая не переносится.
Да. Intlayer с Nuxt охватывает многоязычную маршрутизацию, middleware для определения локали и генерацию sitemap. Если вы используете @nuxtjs/i18n, адаптер совместимости Nuxt i18n является путем миграции.
Да. Плагин синхронизации JSON считывает их с диалектом vue-i18n ({name}, {0}, множественные формы с разделителем "car | cars") и записывает переводы обратно при обновлении через CLI или CMS.
Нативная поддержка ICU находится в разработке. Адаптер @intlayer/vue-i18n поддерживает синтаксис сообщений vue-i18n, включая множественные формы с разделителем и именованную/списочную интерполяцию. О модели плюрализации Intlayer см. содержимое перечисления.
Связанные сравнения
Справочная документация:
Отчёты benchmark:
Чтобы понять, откуда взялись эти библиотеки, прочитайте историю i18n в JavaScript.
Звёзды GitHub
Звёзды GitHub, сильный индикатор популярности проекта, доверия сообщества и долгосрочной актуальности. Хотя они не являются прямой мерой технического качества, они отражают, сколько разработчиков считают проект полезным, следят за его развитием и, вероятно, будут его использовать.
Активность коммитов
Звёзды показывают популярность. Коммиты показывают, сколько работы вкладывается в проект. На момент написания у Intlayer около 7 500 коммитов: больше, чем у большинства сравниваемых здесь библиотек, и примерно в 5 раз больше, чем у next-intl или next-i18next.
- intlify/vue-i18n
- aymericzip/intlayer
Коммиты в основной ветке, источник: GitHub API.
Intlayer это монорепозиторий, поэтому в счёт входят все пакеты для фреймворков, CLI и документация. Считайте коммиты показателем активности, а не качества.
Загрузки npm
- vue-i18n
- vue-intlayer
Источник: API загрузок реестра npm.
Число загрузок вознаграждает самые старые решения, а не лучшие. Библиотеку, выпущенную много лет назад, до сих пор устанавливает каждый проект, который выбрал её тогда, каждый запуск CI и каждый зависящий от неё пакет. Эта цифра измеряет инерцию, а не осознанный выбор.
ИИ-ассистенты усиливают этот эффект. next-intl, i18next и vue-i18n повсюду встречаются в коде, на котором они обучались, поэтому ассистенты предлагают их по умолчанию, не сравнивая альтернативы. Каждая подсказка добавляет загрузки, которые подпитывают следующую. Сравнивайте по бенчмарку, а не по числу загрузок.
Заключение
vue-i18n, зрелая, гибкая и глубоко интегрированная с Vue библиотека. Бенчмарк показывает, во что обходится её runtime-first дизайн в сборке Vite: рантайм 24 КБ gzip, 134,9 КБ на страницу для приложения, которое весит 41 КБ без i18n, 90 % контента чужих страниц на каждой странице и компоненты, каждый из которых достигает 196 КБ, потому что висит на глобальном дереве сообщений.
Intlayer переносит работу в компилятор. Словари по компонентам и очистка мёртвого контента, это результаты сборки, а не соглашения. На том же приложении: рантайм 3,9 КБ, 57,1 КБ на страницу, 0 % утечки страниц, компоненты в 25 раз меньше. А если переписывание не рассматривается, @intlayer/vue-i18n проходит большую часть пути, не затрагивая компоненты.
Все сырые данные, тестовые приложения и скрипты находятся в репозитории Benchmark Bloom. Запустите его сами.
Подробнее см. в документе «Почему Intlayer?».
Комментарии
Пока нет комментариев. Будьте первым, кто поделится своими мыслями.
