Спросите свой вопрос и получите сводку документа, используя эту страницу и выбранного вами поставщика AI
Интеграция сервера MCP Intlayer в ваш любимый AI-ассистент позволяет получать все документы непосредственно из ChatGPT, DeepSeek, Cursor, VSCode и т.д.
Просмотр документации сервера MCPСодержимое этой страницы было переведено с помощью ИИ.
Смотреть последнюю версию оригинального контента на английскомЕсли у вас есть идея по улучшению этой документации, не стесняйтесь внести свой вклад, подав запрос на вытягивание на GitHub.
Ссылка на документацию GitHubКопировать Markdown документа в буфер обмена
Почему стоит рассмотреть Intlayer?
Что такое Intlayer?
Intlayer - это библиотека интернационализации, разработанная специально для JavaScript-разработчиков. Она позволяет объявлять ваш контент в любом месте вашего кода. Она преобразует объявления многоязычного контента в структурированные словари для легкой интеграции в ваш код. Используя TypeScript, Intlayer делает вашу разработку более надежной и эффективной.
Почему был создан Intlayer?
Intlayer был создан для решения общей проблемы, которая затрагивает все популярные библиотеки i18n, такие как next-intl, react-i18next, react-intl, next-i18next, react-intl и vue-i18n.
Все эти решения используют централизованный подход для перечисления и управления вашим контентом. Например:
Копировать код в буфер обмена
.├── locales│ ├── en.json│ ├── fr.json│ └── es.json├── i18n.ts└── src └── components └── MyComponent └── index.tsx
Или здесь с использованием пространств имён:
Копировать код в буфер обмена
.├── locales│ ├── en│ │ ├── footer.json│ │ └── navbar.json│ ├── fr│ │ ├── footer.json│ │ └── navbar.json│ └── es│ ├── footer.json│ └── navbar.json├── i18n.ts└── src └── components └── MyComponent └── index.tsx
Такой тип архитектуры замедляет процесс разработки и усложняет поддержку кода по нескольким причинам:
Для каждого нового созданного компонента необходимо:
- Создать новый ресурс/пространство имён в папке locales
- Не забыть импортировать новое пространство имён на вашей странице
- Перевести ваш контент (часто выполняется вручную путём копирования/вставки из AI-сервисов)
Для любых изменений в ваших компонентах необходимо:
- Найти соответствующий ресурс/пространство имён (которое находится далеко от компонента)
- Перевести ваш контент
- Убедиться, что ваш контент актуален для всех локалей
- Проверить, что в вашем пространстве имён нет неиспользуемых ключей/значений
- Убедиться, что структура ваших JSON-файлов одинакова для всех локалей
В профессиональных проектах, использующих эти решения, часто применяются платформы локализации для управления переводом вашего контента. Однако для крупных проектов это может быстро стать дорогостоящим.
Для решения этой проблемы Intlayer использует подход, при котором контент ограничивается областью компонента и хранится рядом с вашим компонентом, как это часто делается с CSS (styled-components), типами, документацией (storybook) или модульными тестами (jest).
Копировать код в буфер обмена
.└── components └── MyComponent ├── index.content.ts ├── index.test.tsx ├── index.stories.tsx └── index.tsx
Копировать код в буфер обмена
import { t, type Dictionary } from "intlayer";const componentExampleContent = { key: "component-example", content: { myTranslatedContent: t({ en: "Hello World", es: "Hola Mundo", fr: "Bonjour le monde", }), },} satisfies Dictionary;// Экспортируем контент компонента по умолчаниюexport default componentExampleContent;
Копировать код в буфер обмена
import { useIntlayer } from "react-intlayer";export const ComponentExample = () => { const { myTranslatedContent } = useIntlayer("component-example"); return <span>{myTranslatedContent}</span>;};
Этот подход позволяет вам:
Увеличить скорость разработки
- Файлы .content.{{ts|mjs|cjs|json}} можно создавать с помощью расширения для VSCode
- Инструменты автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot) могут помочь вам объявлять ваш контент, уменьшая необходимость копирования/вставки
Очистить вашу кодовую базу
- Снизить сложность
- Повысить поддерживаемость
Проще дублировать ваши компоненты и связанный с ними контент (например: компоненты входа/регистрации и т.д.)
- Ограничивая риск влияния на контент других компонентов
- Копируя и вставляя ваш контент из одного приложения в другое без внешних зависимостей
Избегать загрязнения кодовой базы неиспользуемыми ключами/значениями для неиспользуемых компонентов
- Если вы не используете компонент, Intlayer не будет импортировать его связанный контент
- Если вы удаляете компонент, вам будет проще не забыть удалить связанный с ним контент, так как он будет находиться в той же папке
Снизить затраты на размышления для ИИ-агентов при объявлении вашего многоязычного контента
- ИИ-агенту не нужно сканировать всю вашу кодовую базу, чтобы понять, где реализовать ваш контент
- Переводы легко выполняются с помощью инструментов автозаполнения на базе ИИ в вашей IDE (например, GitHub Copilot)
Дополнительные возможности Intlayer
Функция | Описание |
---|---|
![]() | Поддержка нескольких фреймворков Intlayer совместим со всеми основными фреймворками и библиотеками, включая Next.js, React, Vite, Vue.js, Nuxt, Preact, Express и другие. |
![]() | Управление контентом на основе JavaScript Используйте гибкость JavaScript для эффективного определения и управления вашим контентом. - Объявление контента |
![]() | Файл объявления контента для каждого локалитета Ускорьте разработку, объявляя ваш контент один раз, до автоматической генерации. - Файл объявления контента для каждого локалитета |
![]() | Типобезопасная среда Используйте TypeScript, чтобы гарантировать отсутствие ошибок в определениях контента и коде, а также получать преимущества автозаполнения в IDE. - Настройка TypeScript |
![]() | Упрощённая настройка Быстрый старт с минимальной конфигурацией. Легко настраивайте параметры интернационализации, маршрутизации, ИИ, сборки и обработки контента. - Изучите интеграцию с Next.js |
![]() | Упрощённый доступ к контенту Нет необходимости вызывать функцию t для каждого элемента контента. Получайте весь ваш контент напрямую с помощью одного хука. - Интеграция с React |
![]() | Единообразная реализация серверных компонентов Идеально подходит для серверных компонентов Next.js, используйте одну и ту же реализацию как для клиентских, так и для серверных компонентов, нет необходимости передавать функцию t через каждый серверный компонент. - Серверные компоненты |
![]() | Организованная кодовая база Поддерживайте вашу кодовую базу более организованной: 1 компонент = 1 словарь в той же папке. Переводы, расположенные рядом с соответствующими компонентами, повышают удобство сопровождения и ясность. - Как работает Intlayer |
![]() | Расширенная маршрутизация Полная поддержка маршрутизации приложений, плавно адаптирующаяся к сложным структурам приложений для Next.js, React, Vite, Vue.js и других. - Изучите интеграцию с Next.js |
![]() | Поддержка Markdown Импортируйте и интерпретируйте локализационные файлы и удалённый Markdown для многоязычного контента, такого как политики конфиденциальности, документация и др. Интерпретируйте и делайте метаданные Markdown доступными в вашем коде. - Файлы контента |
![]() | Бесплатный визуальный редактор и CMS Для авторов контента доступен бесплатный визуальный редактор и CMS, что устраняет необходимость в платформе локализации. Сохраняйте синхронизацию контента с помощью Git или полностью/частично внешне управляйте им через CMS. - Редактор Intlayer - CMS Intlayer |
![]() | Контент с поддержкой tree-shaking Контент с поддержкой tree-shaking, уменьшающий размер итогового бандла. Загружает контент по компонентам, исключая неиспользуемый контент из вашего бандла. Поддерживает ленивую загрузку для повышения эффективности загрузки приложения. - Оптимизация сборки приложения |
![]() | Статическая отрисовка Не блокирует статическую отрисовку. - Интеграция с Next.js |
![]() | Перевод с использованием ИИ Преобразуйте ваш сайт на 231 язык всего одним кликом с помощью продвинутых инструментов перевода на базе ИИ от Intlayer, используя вашего собственного поставщика ИИ/ключ API. - Интеграция CI/CD - CLI Intlayer - Автозаполнение |
![]() | Интеграция сервера MCP Обеспечивает сервер MCP (Model Context Protocol) для автоматизации IDE, позволяя бесшовно управлять контентом и процессами интернационализации (i18n) непосредственно в вашей среде разработки. - Сервер MCP |
![]() | Расширение VSCode Intlayer предоставляет расширение для VSCode, которое поможет вам управлять вашим контентом и переводами, создавать словари, переводить ваш контент и многое другое. - Расширение VSCode |
![]() | Взаимодействие Обеспечивает взаимодействие с react-i18next, next-i18next, next-intl и react-intl. - Intlayer и react-intl - Intlayer и next-intl - Intlayer и next-i18next |
Сравнение Intlayer с другими решениями
Функция | Intlayer | React-i18next / i18next | React-Intl (FormatJS) | LinguiJS | next-intl | next-i18next | vue-i18n |
---|---|---|---|---|---|---|---|
Переводы рядом с компонентами | Да, контент расположен рядом с каждым компонентом | Нет | Нет | Нет | Нет | Нет | Да - с использованием Single File Components (SFCs) |
Интеграция с TypeScript | Продвинутая, автоматически сгенерированные строгие типы | Базовая; дополнительная конфигурация для безопасности | Хорошая, но менее строгая | Типы, требуется конфигурация | Хорошая | Базовая | Хорошая (типы доступны; требуется настройка безопасности ключей) |
Обнаружение отсутствующих переводов | Ошибка/предупреждение во время сборки | В основном строки-заменители во время выполнения | Строки-заменители | Требуется дополнительная настройка | Строки-заменители во время выполнения | Строки-заменители во время выполнения | Строки-заменители/предупреждения во время выполнения (настраиваемо) |
Обогащённый контент (JSX/Markdown/компоненты) | Прямая поддержка, включая React-узлы | Ограничено / только интерполяция | Синтаксис ICU, не настоящий JSX | Ограничено | Не предназначено для сложных узлов | Ограничено | Ограничено (компоненты через <i18n-t>, Markdown через плагины) |
Перевод с использованием ИИ | Да, поддерживает нескольких поставщиков ИИ. Можно использовать с собственными API-ключами. Учитывает контекст вашего приложения и объем контента | Нет | Нет | Нет | Нет | Нет | Нет |
Визуальный редактор | Да, локальный визуальный редактор + опциональная CMS; может вынести содержимое кодовой базы; встраиваемый | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации | Нет / доступно через внешние платформы локализации |
Локализованная маршрутизация | Встроенная, поддержка middleware | Плагины или ручная настройка | Не встроена | Плагин/ручная настройка | Встроена | Встроена | Вручную через Vue Router (обрабатывается Nuxt i18n) |
Динамическая генерация маршрутов | Да | Плагин/экосистема или ручная настройка | Не предоставляется | Плагин/ручная настройка | Да | Да | Не предоставляется (предоставляется Nuxt i18n) |
Множественное число | Шаблоны на основе перечислений; см. документацию | Настраиваемо (плагины, такие как i18next-icu) | Продвинутое (ICU) | Продвинутое (ICU/messageformat) | Хорошо | Хорошо | Продвинутое (встроенные правила множественного числа) |
Форматирование (даты, числа, валюты) | Оптимизированные форматтеры (Intl под капотом) | Через плагины или пользовательское использование Intl | Продвинутые ICU форматтеры | Помощники ICU/CLI | Хорошо (помощники Intl) | Хорошо (помощники Intl) | Встроенные форматтеры даты/числа (Intl) |
Формат содержимого | .tsx, .ts, .js, .json, .md, .txt | .json | .json, .js | .po, .json | .json, .js, .ts | .json | .json, .js |
Поддержка ICU | В разработке (родной ICU) | Через плагин (i18next-icu) | Да | Да | Да | Через плагин (i18next-icu) | Через пользовательский форматтер/компилятор |
SEO помощники (hreflang, sitemap) | Встроенные инструменты: помощники для sitemap, robots.txt, метаданные | Плагины сообщества/ручное управление | Не является ядром | Не является ядром | Хорошо | Хорошо | Не является ядром (Nuxt i18n предоставляет помощники) |
Экосистема / Сообщество | Меньше, но быстро растет и активно реагирует | Самое большое и зрелое | Большое, корпоративное | Растущее, меньше | Среднего размера, ориентировано на Next.js | Среднего размера, ориентировано на Next.js | Большое в экосистеме Vue |
Серверный рендеринг и серверные компоненты | Да, оптимизировано для SSR / React Server Components | Поддерживается, требуется некоторая настройка | Поддерживается в Next.js | Поддерживается | Полная поддержка | Полная поддержка | SSR через Nuxt/Vue SSR (без RSC) |
Tree-shaking (загрузка только используемого контента) | Да, на уровне компонентов во время сборки с помощью плагинов Babel/SWC | Обычно загружает всё (можно улучшить с помощью пространств имён/разделения кода) | Обычно загружает всё | Не по умолчанию | Частично | Частично | Частично (с разделением кода/ручной настройкой) |
Ленивая загрузка | Да, по локалям/по компонентам | Да (например, бэкенды/пространства имён по требованию) | Да (разделение пакетов локалей) | Да (динамический импорт каталогов) | Да (по маршрутам/локалям) | Да (по маршрутам/локалям) | Да (асинхронные сообщения локалей) |
Управление крупными проектами | Поощряет модульность, подходит для дизайн-систем | Требует хорошей дисциплины в работе с файлами | Центральные каталоги могут стать большими | Может стать сложным | Модульный с настройкой | Модульный с настройкой | Модульный с настройкой Vue Router/Nuxt i18n |
История документа
Версия | Дата | Изменения |
---|---|---|
5.8.0 | 2025-08-19 | Обновление сравнительной таблицы |
5.5.10 | 2025-06-29 | Инициализация истории |