@intlayer/docs 9.4.2 → 9.4.3

package/blog/ru/is_next-intl_outdated.md

@@ -0,0 +1,363 @@
+---
+createdAt: 2026-09-02
+updatedAt: 2026-09-02
+title: Устарел ли next-intl в 2026 году?
+description: next-intl стал популярным решением для Next.js App Router. Но он по-прежнему создает оверхед в клиентском бандле и требует ручной организации неймспейсов.
+keywords:
+  - next-intl
+  - Intlayer
+  - Интернационализация
+  - i18n
+  - Next.js
+  - Размер бандла
+  - Блог
+  - JavaScript
+slugs:
+  - blog
+  - is-next-intl-outdated
+author: aymericzip
+---
+
+# Устарел ли next-intl в 2026 году?
+
+Когда Vercel представил App Router и убрал встроенную i18n из Pages Router, `next-intl` оперативно занял освободившуюся нишу. Качественная документация Яна Аманна и своевременная поддержка App Router сделали эту библиотеку выбором по умолчанию для многих разработчиков.
+
+Почему же сегодня возникает вопрос о ее актуальности?
+
+**Архитектура веба за последние три года сделала большой шаг вперед, тогда как концептуальная модель `next-intl` осталась на месте.**
+
+Пока Next.js развивал React Server Components (RSC), потоковый рендеринг и оптимизации на уровне компилятора, `next-intl` продолжает решать интернационализацию во время выполнения: передает тяжелые JSON-объекты клиентским провайдерам, выполняет ICU-форматтеры в браузере и полагается на ручную разбивку по неймспейсам для контроля веса бандла.
+
+<TOC/>
+
+## Главные выводы
+
+**Снижение темпов развития:**
+
+За последние 12 месяцев в `next-intl` добавлено ~187 коммитов, преимущественно связанных с адаптацией к релизам Next.js и мелкими исправлениями.
+
+**Клиентский оверхед в runtime:**
+
+Подключение `NextIntlClientProvider` с `useTranslations()` добавляет ~12.8 КБ gzipped (51 КБ minified) еще до вывода текста, что примерно втрое превышает вес `next-intlayer` (4.3 КБ).
+
+**Утечка 90% переводов:**
+
+В типичных конфигурациях **89.8% объема переводов, передаваемых на страницу, принадлежит другим маршрутам**. При переходе на `/contact` попутно загружаются тексты `/pricing` и личного кабинета.
+
+**Ручное управление неймспейсами:**
+
+Чтобы избежать раздувания бандла, приходится вручную делить и связывать неймспейсы с маршрутами, что повышает риск пропустить переводы в продакшене.
+
+**Коммерческое партнерство:**
+
+Будучи официальным партнером Crowdin, проект имеет мало причин разрабатывать бесплатную локальную утилиту ИИ-перевода прямо в CLI.
+
+## Поддержка vs. современные инструменты
+
+Активность коммитов за последние 12 месяцев:
+
+| Репозиторий           | Звезды                                                                                                                                                 | Всего коммитов                                                                                                                                                      | Коммитов / год                                                                                                                                                     | Последний коммит                                                                                                                             |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| `amannn/next-intl`    | [![stars](https://img.shields.io/github/stars/amannn/next-intl?style=for-the-badge&label=stars)](https://github.com/amannn/next-intl/stargazers)       | [![commits](https://img.shields.io/github/commit-activity/t/amannn/next-intl?style=for-the-badge&label=commits)](https://github.com/amannn/next-intl/commits)       | [![yearly](https://img.shields.io/github/commit-activity/y/amannn/next-intl?style=for-the-badge&label=%2Fyear)](https://github.com/amannn/next-intl/commits)       | [![last](https://img.shields.io/github/last-commit/amannn/next-intl?style=for-the-badge)](https://github.com/amannn/next-intl/commits)       |
+| `aymericzip/intlayer` | [![stars](https://img.shields.io/github/stars/aymericzip/intlayer?style=for-the-badge&label=stars)](https://github.com/aymericzip/intlayer/stargazers) | [![commits](https://img.shields.io/github/commit-activity/t/aymericzip/intlayer?style=for-the-badge&label=commits)](https://github.com/aymericzip/intlayer/commits) | [![yearly](https://img.shields.io/github/commit-activity/y/aymericzip/intlayer?style=for-the-badge&label=%2Fyear)](https://github.com/aymericzip/intlayer/commits) | [![last](https://img.shields.io/github/last-commit/aymericzip/intlayer?style=for-the-badge)](https://github.com/aymericzip/intlayer/commits) |
+
+Показатели за прошедший год:
+
+- `amannn/next-intl`: **187 коммитов** (обновления зависимостей и небольшие патчи).
+- `aymericzip/intlayer`: **4 343 коммита** (активная работа над компилятором, плагинами для IDE, MCP-серверами и алгоритмами перевода).
+
+[![Star History Chart](https://api.star-history.com/chart?repos=amannn%2Fnext-intl%2Caymericzip%2Fintlayer&type=date&legend=top-left)](https://www.star-history.com/#amannn/next-intl&aymericzip/intlayer)
+
+Стабильная библиотека полезна, но подходы к i18n изменились: компиляторы удаляют неиспользуемые строки при сборке, нейросети переводят тексты в CI, а среды разработки подключают LSP и ИИ-помощников. Архитектура, сосредоточенная на времени выполнения, с трудом использует эти возможности.
+
+## Тестирование в Next.js 16 App Router
+
+Бенчмарк проведен на стандартном приложении App Router с 10 маршрутами и 10 языками:
+
+<I18nBenchmark framework="nextjs" vertical/>
+
+<ClickToOpenIframe
+src="https://intlayer.org/markdown?url=https%3A%2F%2Fraw.githubusercontent.com%2Fintlayer-org%2Fbenchmark-i18n%2Fmain%2Freport%2Fscripts%2Fsummarize-nextjs.md"
+width="100%"
+height="600px"
+style="border:none;"
+/>
+
+> Измерения в реальных браузерах с gzip-сжатием. Все подробности в [отчете о бенчмарке Next.js](https://intlayer.org/ru/doc/benchmark/nextjs).
+
+### Базовый размер библиотек
+
+Вес клиентской части до добавления текстов:
+
+| Библиотека             | Gzipped    | Minified    |
+| ---------------------- | ---------- | ----------- |
+| `next-intl@4.9.1`      | 12.8 КБ    | 51.0 КБ     |
+| `next-intlayer@8.7.12` | **4.3 КБ** | **13.3 КБ** |
+
+### Вес страниц и утечки контента
+
+| Конфигурация           | Ср. JS / стр. (gz) | Утечка языков | Утечка др. страниц | Ср. компонент (gz) |
+| ---------------------- | ------------------ | ------------- | ------------------ | ------------------ |
+| База (без i18n)        | 150.8 КБ           | 0.0%          | 0.0%               | 0.7 КБ             |
+| `next-intl` (статика)  | 163.5 КБ           | 4.2%          | **89.8%**          | 20.5 КБ            |
+| `next-intl` (динамика) | 163.4 КБ           | 9.7%          | **89.9%**          | 20.5 КБ            |
+| `next-intlayer`        | **152.1 КБ**       | **0.0%**      | **0.0%**           | **7.2 КБ**         |
+
+### Причина утечек между страницами
+
+В классических проектах с `next-intl` корневой layout загружает весь объем переводов сразу:
+
+```tsx fileName="app/[locale]/layout.tsx"
+export default async function RootLayout({ children, params }) {
+  const messages = await getMessages();
+
+  return (
+    <html>
+      <body>
+        <NextIntlClientProvider messages={messages}>
+          {children}
+        </NextIntlClientProvider>
+      </body>
+    </html>
+  );
+}
+```
+
+Поскольку `messages` попадает в клиентский провайдер в самом верху дерева, браузер скачивает весь словарь на каждой странице. Посетитель страницы `/login` загружает описания функций, разделы помощи и интерфейс личного кабинета.
+
+Частично это решается делением на неймспейсы. Но ручное отслеживание привязки текстов к маршрутам трудоемко и часто приводит к сбоям.
+
+Intlayer решает эту задачу с помощью статического анализа: [компилятор Intlayer](https://intlayer.org/ru/doc/compiler) бандлит исключительно те строки, которые задействованы на конкретном маршруте, снижая утечку до **0.0%**.
+
+## Почему next-intl не поддается tree-shaking
+
+Интерфейс библиотеки опирается на строковые вызовы ключей во время выполнения:
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="next-intl" value="next-intl">
+
+```tsx fileName="UserProfile.tsx"
+"use client";
+
+import { useTranslations } from "next-intl";
+
+export function UserProfile() {
+  const t = useTranslations("UserProfile");
+
+  return <h2>{t("heading")}</h2>;
+}
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```tsx fileName="UserProfile.tsx"
+"use client";
+
+import { useIntlayer } from "next-intlayer";
+
+export function UserProfile() {
+  const { heading } = useIntlayer("user-profile");
+
+  return <h2>{heading}</h2>;
+}
+```
+
+  </Tab>
+</Tabs>
+
+Turbopack и Webpack не могут предсказать, какие именно ключи из `UserProfile` будут вызваны. Чтобы не допустить падения приложения, **бандлер включает весь неймспейс целиком в клиентский чанк**. Деструктурированные свойства в Intlayer позволяют компилятору четко видеть зависимости и вырезать ненужные поля. Подробнее в [оптимизации бандла](https://intlayer.org/ru/doc/concept/bundle-optimization).
+
+## Опыт разработки
+
+### Внешний JSON против совместного размещения
+
+В `next-intl` тексты хранятся в отдельных JSON-файлах в папке `messages/`. Intlayer располагает файлы контента рядом с компонентами:
+
+<Tabs defaultTab="intlayer" group="techno">
+  <Tab label="next-intl" value="next-intl">
+
+```json fileName="messages/en.json"
+{
+  "authModal": {
+    "title": "Sign in to your account",
+    "submitButton": "Continue"
+  }
+}
+```
+
+```json fileName="messages/ru.json"
+{
+  "authModal": {
+    "title": "Войдите в аккаунт",
+    "submitButton": "Продолжить"
+  }
+}
+```
+
+```tsx fileName="AuthModal.tsx"
+import { useTranslations } from "next-intl";
+
+export const AuthModal = () => {
+  const t = useTranslations("authModal");
+  return (
+    <form>
+      <h2>{t("title")}</h2>
+      <button type="submit">{t("submitButton")}</button>
+    </form>
+  );
+};
+```
+
+  </Tab>
+  <Tab label="Intlayer" value="intlayer">
+
+```ts fileName="AuthModal.content.ts"
+import { t, type Dictionary } from "intlayer";
+
+export default {
+  key: "auth-modal",
+  content: {
+    title: t({
+      en: "Sign in to your account",
+      ru: "Войдите в аккаунт",
+    }),
+    submitButton: t({
+      en: "Continue",
+      ru: "Продолжить",
+    }),
+  },
+} satisfies Dictionary;
+```
+
+```tsx fileName="AuthModal.tsx"
+import { useIntlayer } from "next-intlayer";
+
+export const AuthModal = () => {
+  const { title, submitButton } = useIntlayer("auth-modal");
+  return (
+    <form>
+      <h2>{title}</h2>
+      <button type="submit">{submitButton}</button>
+    </form>
+  );
+};
+```
+
+  </Tab>
+</Tabs>
+
+При удалении или рефакторинге `AuthModal.tsx` его переводы перемещаются или удаляются вместе с ним.
+
+### Автодополнение против строгой проверки полноты
+
+Расширение `IntlMessages` в `next-intl` обеспечивает автодополнение в редакторе по основному языковому файлу:
+
+```ts fileName="global.d.ts"
+import en from "./messages/en.json";
+
+type Messages = typeof en;
+
+declare global {
+  interface IntlMessages extends Messages {}
+}
+```
+
+Однако контроль распространяется лишь на базовый язык. Если ключ пропадет из `ru.json`, TypeScript не выдаст ошибок, CI останется успешным, а пользователи увидят пустые места.
+
+Intlayer генерирует типы на основе всех файлов контента. Активация режима [`strictMode`](https://intlayer.org/ru/doc/concept/configuration) останавливает сборку при отсутствии перевода в любой из указанных локалей.
+
+### Сравнение инструментария и поддержка ИИ
+
+| Возможность                     | `next-intl` | Intlayer                                                                   |
+| ------------------------------- | ----------- | -------------------------------------------------------------------------- |
+| **Расширение VS Code**          | ❌ Нет      | ✅ [Официальное расширение](https://intlayer.org/ru/doc/vs-code-extension) |
+| **Language Server (LSP)**       | ❌ Нет      | ✅ [Встроенный LSP](https://intlayer.org/ru/doc/lsp)                       |
+| **MCP Server (для ИИ-агентов)** | ❌ Нет      | ✅ [Готовый MCP-сервер](https://intlayer.org/ru/doc/mcp-server)            |
+| **Навыки агентов (Skills)**     | ❌ Нет      | ✅ [Доступные навыки](https://intlayer.org/ru/doc/agent_skills)            |
+| **Визуальная CMS**              | ❌ Нет      | ✅ [Бесплатно и Open Source](https://intlayer.org/ru/doc/concept/editor)   |
+
+Собственные серверы LSP и MCP дают ИИ-ассистентам возможность анализировать структуру контента и точно предлагать или актуализировать переводы.
+
+## Связь с Crowdin и развитие продукта
+
+`next-intl` является официальным партнером Crowdin. Спонсорство помогает развивать проект, однако задает приоритеты: ориентируясь на сторонние TMS-платформы, библиотека не ставит целью создание встроенной бесплатной локальной ИИ-утилиты для перевода.
+
+Intlayer предлагает эти решения из коробки:
+
+**Локальный ИИ-перевод (`intlayer fill`):**
+
+Находит и переводит недостающие строки через ваши личные API-ключи OpenAI, Anthropic, Mistral или Gemini.
+
+**Автономная визуальная CMS:**
+
+Используйте [Intlayer CMS](https://intlayer.org/ru/doc/concept/cms) для визуального редактирования с сохранением изменений напрямую в Git.
+
+**Лицензия Apache 2.0:**
+
+Все компоненты экосистемы полностью открыты.
+
+## Где next-intl все еще удобен?
+
+<AccordionGroup>
+<Accordion header="Сложные конструкции ICU MessageFormat">
+
+Если в приложении активно применяются специфические конструкции порядковых и множественных форм, ICU-движок `next-intl` полностью справляется с задачей.
+
+</Accordion>
+<Accordion header="Налаженные процессы с Crowdin">
+
+Для команд, чья инфраструктура переводов уже плотно интегрирована с Crowdin, библиотека подходит органично.
+
+</Accordion>
+<Accordion header="Работающие стабильные проекты">
+
+Если приложение отвечает всем требованиям, а размер бандла устраивает команду, миграция не является критичной.
+
+</Accordion>
+</AccordionGroup>
+
+## Как улучшить текущую конфигурацию next-intl?
+
+Intlayer предоставляет готовый пакет совместимости, который точно повторяет сигнатуры функций и хуков `next-intl` (такие как `useTranslations`, `getTranslations` и утилиты маршрутизации). Вам не нужно переписывать компоненты или страницы, чтобы получить оптимизацию на уровне компилятора.
+
+Настройка выполняется одной командой:
+
+```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
+```
+
+Интерактивный интерфейс командной строки:
+
+1. Устанавливает пакет совместимости `@intlayer/next-intl`.
+2. Настраивает алиасы сборщика, чтобы привычные импорты (`next-intl`, `next-intl/server`) прозрачно вели на Intlayer, позволяя удалить старую библиотеку из `package.json`.
+3. Сразу активирует поддержку языкового сервера (LSP), исключает перекрестные утечки переводов между страницами (полный tree-shaking) и включает локальные процессы ИИ-перевода без масштабного рефакторинга.
+
+Подробные инструкции можно найти в наших руководствах:
+
+- **Прямая совместимость:** Сохраняйте вызовы `useTranslations`, используя [адаптер совместимости с next-intl](https://intlayer.org/ru/doc/compatibility/next-intl).
+- **Руководство по миграции:** Преобразуйте существующие JSON-файлы в типизированные словари с помощью [инструкции по миграции](https://intlayer.org/ru/doc/migration/next-intl).
+- **Гибридный вариант:** Оставьте `next-intl` для вывода интерфейса, подключив [Intlayer к next-intl](https://intlayer.org/ru/blog/intlayer-with-next-intl) для локального перевода через ИИ.
+
+Оцените вес и утечки вашего проекта с помощью бесплатного [SEO-сканера i18n](https://intlayer.org/i18n-seo-scanner):
+
+<ClickToOpenIframe src="https://intlayer.org/i18n-seo-scanner" width="100%" height="600px" style="border:none;"/>
+
+## Дополнительные материалы
+
+- [Бенчмарк Next.js i18n: подробный разбор производительности](https://intlayer.org/ru/doc/benchmark/nextjs)
+- [next-i18next против next-intl и Intlayer](https://intlayer.org/ru/blog/next-i18next-vs-next-intl-vs-intlayer)
+- [Устарел ли i18next в 2026 году?](https://intlayer.org/ru/blog/is-i18next-outdated)
+- [Преимущества архитектуры i18n на базе компилятора](https://intlayer.org/ru/blog/compiler-vs-declarative-i18n)