Автор:

Создание:2026-09-16Последнее обновление:2026-09-16

Ссылайтесь на этот документ на ваш любимый ассистент AIChatGPT Claude DeepSeek Google AI mode Gemini Perplexity Mistral Grok

Спросите свой вопрос и получите сводку документа, используя эту страницу и выбранного вами поставщика AI

Содержимое этой страницы было переведено с помощью ИИ.

Смотреть последнюю версию оригинального контента на английском

Изменить эту документацию

Если у вас есть идея по улучшению этой документации, не стесняйтесь внести свой вклад, подав запрос на вытягивание на GitHub.

Ссылка на документацию GitHub

Копировать

Копировать Markdown документа в буфер обмена

Как выбрать подходящую библиотеку i18n для Solid

Модель реактивности Solid меняет то, что должна делать библиотека i18n. Компоненты выполняются один раз, поэтому перевод, сохраненный в const при инициализации (setup), превращается в застывшую строку. Библиотека, возвращающая строки вместо accessors, приведет к тому, что язык на странице переключится везде, кроме тех трех компонентов, где кто-то так сделал. Выбор библиотеки для Solid заключается как в удобстве API, так и в том, насколько сложно в ней допустить такую ошибку.

В этом руководстве перечислены вопросы, на которые стоит ответить в первую очередь, а затем они сопоставляются с @solid-primitives/i18n, solid-i18next, Paraglide, @lingui/solid и Intlayer как для связки Vite + Solid, так и для SolidStart.

Экосистема библиотек i18n для Solid

Шесть вопросов перед сравнением библиотек

Vite SPA или SolidStart? В SPA локаль может храниться в обычном signal. В SolidStart локаль должна определяться на сервере из URL, а все данные, которые поисковый робот должен видеть без JavaScript (<html lang>, hreflang), должны находиться в entry-server.tsx.
Насколько реактивной должна быть смена локали? Полная перезагрузка страницы при переключении приемлема для некоторых приложений. Если нет, значения библиотеки должны быть signals или accessors, а их чтение должно отслеживаться, а не копироваться.
Кто пишет переводы? Разработчики, TMS, агентство, предоставляющее строки ICU, или AI-пайплайн. solid-i18next использует формат i18next. @solid-primitives/i18n работает с любым объектом словаря. Выбирайте под поставщика переводов.
Сколько локалей и страниц? Две локали и пять страниц могут позволить себе отправлять всё сразу. Десять локалей и сорок маршрутов не могут, и lazy-каталоги вместе со scoping становятся основной статьей расходов.
Нужна ли типизация ключей? @solid-primitives/i18n выводит их из исходного словаря. solid-i18next требует ручного объявления. Библиотеки времени компиляции генерируют их автоматически.
Какой объем функциональности вам нужен? Управление cookie, маршрутизация с префиксом локали, редиректы, форматтеры. В самом легковесном варианте ничего этого нет, и это нормально, пока не возникнет реальная необходимость.

Запишите ответы. Всё изложенное ниже будет опираться на них.

Общая картина

Solid, самая молодая экосистема в этом ряду, имеет наименьшее количество вариантов, разделенных на три волны.

История библиотек i18n в JavaScript

Обертка i18next для Solid. Пространства имен (namespaces), бэкенды, детекторы и десятилетие плагинов. Самый тяжелый вариант из всех с теми же накладными расходами на вызовы t("a.b"), что и в React.

Плоский словарь, которым вы управляете сами, функция translator(), возвращающая accessors, и типы, выводимые из исходного объекта. Очень компактный, без scoping, без маршрутизации и без форматтеров. Выбор по умолчанию в сообществе.

Paraglide генерирует отдельную функцию для каждого сообщения. Intlayer объявляет контент для каждого компонента в файлах .content.ts и возвращает узлы на базе signals. Биндинг Lingui для Solid появился в 2026 году и предлагает извлечение переводов на основе макросов.

Статья об истории JavaScript i18n подробно рассматривает каждую волну.

Главное архитектурное решение: где хранится контент и когда он загружается

Два структурных фактора объясняют большую часть различий в размере bundle между решениями:

Централизованный или изолированный (scoped) контент. Один общий словарь на всё приложение или отдельное объявление для каждого компонента.
Статический или динамический импорт. Загрузка всего контента при старте или подгрузка активной локали (и в идеале активного маршрута) по требованию.

График оценивает объем передаваемых данных для теоретического приложения размером от 1 до 10 страниц, переведенного на 1–10 локалей, с объемом текста около 30 КБ на страницу.

Теоретическая утечка контента в зависимости от архитектуры

@solid-primitives/i18n не решает эти задачи из коробки: вы используете createResource для словаря каждой локали, что дает динамическую загрузку, а остальное реализуете сами. solid-i18next поддерживает namespaces и lazy backends, но ничто не контролирует их разделение: если общий компонент импортирует common, он становится зависимостью каждого маршрута. Paraglide оптимизирует разделение по страницам с помощью tree-shaking, хотя в Solid benchmark этого эффекта достичь не удалось. Intlayer обеспечивает разделение за счет деклараций на уровне отдельных компонентов.

Если вашим ответом на вопрос 4 было «много страниц», уделите этому разделу больше внимания, чем предпочтениям в API. В статье о колокации против централизованного i18n рассматривается аспект поддержки того же компромисса.

Кандидаты

Размеры библиотек взяты из Solid benchmark: provider плюс accessor в пустом компоненте после сборки, tree-shaking и минификации в приложении на 10 страниц и 10 локалей. Объем контента измеряется отдельно.

Показать все данные таблицы

Открыть таблицу в модальном окне для четкого просмотра всех данных

Библиотека	Модель контента	Реактивность при смене локали	Типизация ключей	Scoping и lazy loading	Размер библиотеки
`@solid-primitives/i18n`	Плоский словарь под вашим управлением	Signal, accessors, возвращаемые translator	Выводится из исходного словаря	Нет встроенного	Очень маленький
`solid-i18next`	Каталоги и namespaces i18next	Store, повторный рендер через provider	Ручное объявление	Namespaces, lazy backends	~14.9 КБ
Paraglide	Проект inlang, сгенерированные функции	Чтение из cookie или storage при вызове	Сгенерированная	Tree-shaking (не в бенчмарке)	Почти нулевой
`@lingui/solid`	Исходный текст в коде, скомпилированные каталоги	На основе signals	От компилятора	По каталогам	Маленький
Intlayer	Один `.content.ts` на компонент	Узлы на signals, без повторного запуска компонентов	Сгенерированная, включена по умолчанию	Да, на уровне компонентов	Базовый (Baseline)

Цифры отражают состояние на момент версий бенчмарка. Пакет @lingui/solid не участвовал в бенчмарке. Протестируйте библиотеки на своем приложении, прежде чем принимать решение только на основе размера.

Почти нулевой размер библиотеки Paraglide обусловлен ее архитектурой: runtime генерируется прямо в ваш репозиторий. Для Intlayer требуется vite-intlayer, поэтому он не может работать без этапа сборки (build step).

Сопоставление ответов с библиотеками

@solid-primitives/i18n. Плоский словарь, translator(), возвращающий accessors, и типы, выводимые без дополнительных настроек. Это отличный выбор для небольшого приложения, а чтение исходного кода займет десять минут. Что придется написать самостоятельно: сохранение локали, маршрутизацию, форматтеры и разделение по маршрутам. Если этот список начинает расти, это сигнал к переходу на другое решение.

solid-i18next позволяет переиспользовать каталоги, namespaces, бэкенды и детекторы без изменений. Это самый тяжелый вариант, который несет в себе те же накладные расходы, что и react-i18next: ручное объявление типов, возможные, но трудоемкие оптимизации, а также функцию t(), возвращающую строку, из-за чего легко допустить ошибку с застывшим переводом. Оборачивайте чтение в JSX или createMemo и никогда не сохраняйте результат в переменные при инициализации (setup).

Локаль должна извлекаться из URL на сервере, чтобы данные на обеих сторонах совпадали; определять ее на клиенте уже слишком поздно. @solid-primitives/i18n и solid-i18next оставляют маршрут [[locale]], matchFilters, редиректы и теги в entry-server.tsx на ваше усмотрение. У Paraglide есть плагин для Vite, отвечающий за маршрутизацию. Intlayer поставляется с готовыми middleware и хелперами маршрутов. Что бы вы ни выбрали, размещайте <html lang> и hreflang в entry-server.tsx; @solidjs/meta применяется на клиенте только после гидратации в SolidStart v2. В статье об i18n в Solid подробно описана эта настройка.

Выбирайте библиотеку, чьи значения представлены в виде signals или accessors, а их чтение отслеживается. Accessors в @solid-primitives/i18n и узлы Intlayer обновляют только те DOM-узлы, которые их читают, без повторного выполнения самого компонента. solid-i18next выполняет повторный рендер через provider. Paraglide считывает локаль из cookie или storage при каждом вызове сообщения вместо использования signal, что работает, но создает больше лишних операций на каждый узел.

Изолированный контент, компилируемый на этапе сборки. Intlayer отправляет в браузер только то, что рендерит конкретный маршрут. Paraglide должен достигать этого через tree-shaking (проверьте это в своей конфигурации, так как в бенчмарке этого не произошло). При использовании solid-i18next спланируйте стратегию namespaces и lazy-загрузки с первого дня и контролируйте ее на code review.

@solid-primitives/i18n предоставляет автоматически выводимые типы из коробки, чего не предлагает большинство библиотек для React. Если нужны сгенерированные типы, сохраняющиеся при lazy-загрузке и разделении по маршрутам, Paraglide, @lingui/solid и Intlayer создают их напрямую из контента. В статье об обнаружении недостающих переводов сравнивается, какие ошибки каждая библиотека отлавливает на этапе сборки.

В таком случае централизованный словарь теряет свое главное преимущество. Колокация контента вместе с CLI, заполняющим недостающие локали, представляет собой более короткий путь. Команда fill в Intlayer работает с вашим собственным API-ключом (OpenAI, Anthropic, Mistral, Gemini) и повторно переводит только измененные фрагменты.

В чем ограничения каждой библиотеки

@solid-primitives/i18n: нет встроенной lazy-загрузки или scoping кроме того, что вы напишете сами, нет маршрутизации, нет работы с cookie и нет форматтеров. Отлично подходит для небольших проектов, но быстро перестает удовлетворять требованиям профессиональных приложений.
solid-i18next: самый тяжелый вариант, ручная типизация, собственный формат плюрализации, а t() возвращает строку, из-за чего переводы застывают при сохранении в переменные во время инициализации компонента.
Paraglide: сгенерированные файлы сохраняются в репозиторий и пересоздаются перед каждым push, tree-shaking не сработал в Solid benchmark, а локаль считывается из хранилища при каждом вызове вместо использования signal.
@lingui/solid: новинка 2026 года, поэтому опыта эксплуатации в production пока мало. Наследует шаг сборки Lingui с extract / compile и несколько пересекающихся синтаксисов.
Intlayer: обязательный плагин для сборщика, меньшая экосистема, частичная поддержка ICU и контент, распределенный по всей кодовой базе по замыслу архитектуры, поэтому для экспорта единого JSON для переводчика потребуются дополнительные инструменты.

Как каждый вариант выглядит в коде

Один и тот же компонент, сводка корзины с заголовком и формой множественного числа, реализованный с помощью каждого кандидата. Обратите внимание на то, где читается перевод: внутри JSX чтение отслеживается, а в теле setup-функции превращается в застывшую строку.

src/i18n/index.ts

Копировать код

Копировать код в буфер обмена

import * as i18n from "@solid-primitives/i18n";

export const en = {
  cart: { title: "Your cart", items: "{{ count }} items" },
};

export const dictionary = () => i18n.flatten(en);
export const t = i18n.translator(dictionary, i18n.resolveTemplate);

src/components/CartSummary.tsx

Копировать код

Копировать код в буфер обмена

import type { Component } from "solid-js";
import { t } from "../i18n";

export const CartSummary: Component<{ count: number }> = (props) => (
  <section>
    <h2>{t("cart.title")}</h2>
    <p>{t("cart.items", { count: props.count })}</p>
  </section>
);

Ключи типизируются из объекта без кодогенерации. Здесь нет правил плюрализации, lazy-загрузки и маршрутизации; всё это предстоит добавить вам.

public/locales/en/cart.json

Копировать код

Копировать код в буфер обмена

{
  "title": "Your cart",
  "items_one": "{{count}} item",
  "items_other": "{{count}} items"
}

src/components/CartSummary.tsx

Копировать код

Копировать код в буфер обмена

import { useTransContext } from "@mbarzda/solid-i18next";
import type { Component } from "solid-js";

export const CartSummary: Component<{ count: number }> = (props) => {
  const [t] = useTransContext();

  return (
    <section>
      <h2>{t("cart:title")}</h2>
      <p>{t("cart:items", { count: props.count })}</p>
    </section>
  );
};

Каталоги, namespaces и плагины i18next в исходном виде. Функция t возвращает строку, поэтому const title = t("cart:title") при инициализации зафиксирует значение; вызывайте функцию непосредственно внутри JSX.

messages/en.json

Копировать код

Копировать код в буфер обмена

{
  "cart_title": "Your cart",
  "cart_items": "{count} items"
}

src/components/CartSummary.tsx

Копировать код

Копировать код в буфер обмена

import type { Component } from "solid-js";
import { m } from "../paraglide/messages.js";

export const CartSummary: Component<{ count: number }> = (props) => (
  <section>
    <h2>{m.cart_title()}</h2>
    <p>{m.cart_items({ count: props.count })}</p>
  </section>
);

Каждое сообщение представляет собой сгенерированную типизированную функцию. Локаль считывается из cookie или storage при каждом вызове, а не из signal, поэтому реактивность при переключении языка настраивается вручную.

src/components/cartSummary.content.ts

Копировать код

Копировать код в буфер обмена

import { type Dictionary, plural, t } from "intlayer";

const cartSummaryContent = {
  key: "cart-summary",
  content: {
    title: t({
      ru: "Ваша корзина",
      en: "Your cart",
      fr: "Votre panier",
      es: "Tu carrito",
    }),
    items: plural({
      one: t({
        ru: "{{count}} товар",
        en: "{{count}} item",
        fr: "{{count}} article",
      }),
      other: t({
        ru: "{{count}} товаров",
        en: "{{count}} items",
        fr: "{{count}} articles",
      }),
    }),
  },
} satisfies Dictionary;

export default cartSummaryContent;

src/components/CartSummary.tsx

Копировать код

Копировать код в буфер обмена

import { useIntlayer } from "solid-intlayer";
import type { Component } from "solid-js";

export const CartSummary: Component<{ count: number }> = (props) => {
  const content = useIntlayer("cart-summary");

  return (
    <section>
      <h2>{content.title}</h2>
      <p>{content.items(props.count)}</p>
    </section>
  );
};

Все локали находятся в одном файле рядом с компонентом. useIntlayer возвращает узлы на основе signals, поэтому смена локали обновляет только те DOM-узлы, которые их читают. Выражение {content.title} в JSX отслеживается; content.title.value в теле setup, нет.

Для существующей кодовой базы на i18next адаптер совместимости с i18next подменяет alias пакета на уровне сборщика, благодаря чему каталоги и t() продолжают работать, пока Intlayer отдает контент. Остальные шаги описаны в руководстве по миграции.

На что обратить внимание перед выбором

Таблица возможностей показывает, что библиотека умеет сегодня. Следующие пункты подскажут, каково будет поддерживать ее в долгосрочной перспективе.

Проверьте активность репозитория.

Коммиты, скорость ответов на issues и был ли последний минорный релиз в этом году. Продуманная архитектура без мейнтейнера, это будущая вынужденная миграция.

Не ориентируйтесь только на количество скачиваний в npm.

Самая скачиваемая библиотека, это та, которая появилась первой, а не та, которая лучше всего подходит для кодовой базы Solid в 2026 году. Количество загрузок отражает историю, а не соответствие текущим задачам.

Рейтинг библиотек i18n для JavaScript

Узнайте, кто финансирует мейнтейнера и что они продают.

i18next (лежащий в основе solid-i18next) поддерживается платформой Locize. next-intl, vue-i18n, svelte-i18n и Lingui поддерживаются Crowdin. Tolgee, Paraglide (inlang) и Intlayer развивают собственные платформы. Поставщик, чей доход строится на платном хостинге переводов, мало заинтересован в том, чтобы сделать переводы бесплатными внутри вашего инструментария. Intlayer, единственный в этом списке, кто предлагает AI-перевод через CLI с вашим собственным API-ключом и CMS с возможностью self-hosting.

Готова ли библиотека к работе с AI-агентами?

Агенты по-прежнему испытывают трудности с i18n: забывают локали, выдумывают несуществующие ключи и смешивают синтаксисы сообщений. Предоставляет ли библиотека Agent Skills или MCP-сервер, чтобы агент мог просматривать, заполнять и тестировать контент? Оптимизирована ли загрузка контента по умолчанию, или кому-то придется ежеквартально проверять namespaces и lazy-импорты?

Типобезопасность из коробки.

Не «можно настроить типы при дополнительных усилиях», а «неверный ключ приводит к ошибке tsc сразу после чистой установки». Проверьте, что происходит при обращении к несуществующему ключу и если в какой-то локали отсутствует перевод.

Обнаружение неиспользуемого контента.

Словари со временем только разрастаются. Сборщик Intlayer удаляет неиспользуемые поля и логирует их (build.purge). Paraglide добивается этого архитектурно, так как невызываемая функция сообщения отсекается с помощью tree-shaking. Все остальные решения оставляют очистку на вашей ответственности.

Удобство для разработчиков (DX).

Время от установки до первой переведенной строки, наличие LSP или расширения для VS Code, показывающего перевод при наведении и позволяющего перейти к объявлению, CLI для заполнения, тестирования и пуша, а также возможность для нетехнических специалистов редактировать контент (визуальный редактор или CMS) без pull request.

Часто задаваемые вопросы

Для небольшого приложения, да, и это самый легковесный из доступных вариантов. Его возможностей перестает хватать, когда вам требуются lazy-каталоги для каждого маршрута, маршрутизация с локалями в SolidStart, сохранение в cookie или форматтеры, поскольку всё это придется разрабатывать самостоятельно.

Потому что компоненты Solid выполняются один раз. Перевод, прочитанный в const при инициализации, является обычной строкой, а не реактивной подпиской. Читайте его внутри JSX, effect или memo, либо выберите библиотеку со значениями в виде accessors, где такую ошибку допустить гораздо труднее.

Только если размер bundle, сгенерированные типы или проверка отсутствующих ключей на этапе сборки являются обязательными требованиями. В статье о компиляторах против декларативного i18n объясняется, что дают компиляторы и в каких случаях они могут подвести.

Косвенно. Поисковые роботы обращают внимание на маршрутизацию, hreflang, <html lang> и наличие текста в HTML, отрендеренном на сервере, что в SolidStart означает корректную настройку entry-server.tsx. Ознакомьтесь с руководством по hreflang.

Дополнительные материалы

Выбор i18n-библиотек для Svelte Next.js

Последние сообщения

Как выбрать подходящую библиотеку i18n для React в 2026 году

Руководство по выбору инструментов интернационализации React. На какие вопросы ответить перед сравнением react-i18next, react-intl, Lingui, use-intl, Paraglide и Intlayer, и во сколько каждый выбор обходится в плане размера bundle, типизации и поддержки.

Aymeric PINEAU

Как выбрать подходящую библиотеку i18n для Vue в 2026 году

Руководство по выбору инструментов интернационализации для Vue и Nuxt. На какие вопросы ответить перед сравнением vue-i18n, @nuxtjs/i18n, fluent-vue, Paraglide и Intlayer, и во сколько каждый выбор обходится в плане размера bundle, типизации и SSR payload.

Aymeric PINEAU

Как выбрать подходящую библиотеку i18n для Svelte в 2026 году

Руководство по интернационализации Svelte и SvelteKit. На какие вопросы ответить перед сравнением svelte-i18n, Paraglide, typesafe-i18n, wuchale и Intlayer, и во сколько каждый выбор обходится в плане размера bundle, типизации и SSR.

Aymeric PINEAU

next-intl vs Intlayer: Benchmark и сравнение 2026

Bundle size, утечки контента, реактивность переключения локали и опыт разработчика, измеренные на Next.js и TanStack Start. Какую библиотеку i18n вам выбрать в 2026?

Aymeric PINEAU

Как выбрать подходящую библиотеку i18n для Solid

Table of Contents

Шесть вопросов перед сравнением библиотек

Общая картина

Главное архитектурное решение: где хранится контент и когда он загружается

Кандидаты

Сопоставление ответов с библиотеками

В чем ограничения каждой библиотеки

Как каждый вариант выглядит в коде

На что обратить внимание перед выбором

Часто задаваемые вопросы

Дополнительные материалы

Комментарии

Похожие сообщения

Последние сообщения