Tác giả:
    Ngày tạo:2026-06-13Cập nhật lần cuối:2026-06-13

    Di Chuyển Từ next-intl Sang Intlayer

    Để có hướng dẫn từng bước đầy đủ và chi tiết, vui lòng xem Hướng Dẫn Di Chuyển next-intl đầy đủ của chúng tôi.

    Việc di chuyển từ next-intl sang Intlayer cho phép bạn duy trì routing và cú pháp của ứng dụng hoàn toàn không bị gián đoạn.

    Phải làm gì

    Thực thi lệnh sau trong repository của bạn:

    bash
    npx intlayer init

    Lệnh này sẽ tạo một intlayer.config.ts. Trong next.config.ts của bạn, hãy sử dụng wrapper plugin để liền mạch chèn các bí danh next-intl hướng đến @intlayer/next-intl.

    next.config.ts
    import type { NextConfig } from "next";import { createNextIntlPlugin } from "@intlayer/next-intl/plugin";const withIntlayer = createNextIntlPlugin();const nextConfig: NextConfig = {};export default withIntlayer(nextConfig);

    Những gì diễn ra bên dưới

    Wrapper bundler thay thế các bản dịch, nhưng giữ nguyên các tính năng next-intl/navigation (ví dụ: Link, redirect, usePathname).

    Bên dưới:

    • Runtime ICU: Số nhiều (=0, one, other), select/selectordinal, đối số # và các đối số được định dạng ({ts, date, long}) chạy chính xác bằng cách sử dụng resolver resolveMessage(..., 'icu') được chia sẻ.
    • useTranslations() & getTranslations(): Các lời gọi phạm vi đơn giản trích xuất đoạn key đầu tiên làm định danh từ điển chính xác. Các namespace lồng nhau được tách một cách uyển chuyển thành các đường dẫn từ điển và tiền tố.
    • Định dạng phong phú: Cả t.rich()t.markup() đều được triển khai gốc đầy đủ, chuyển đổi các nút dạng HTML thành các chunk React được hiển thị.
    • useFormatter: relativeTime, list, dateTimeRange và các định dạng được đặt tên từ cấu hình kết nối với các formatter Intl gốc của core.