常见问题

    在 Next.js 中使用 Intlayer 而路径中不含 [locale]

    了解如何在页面路径中不使用 `[locale]` 来搭配 Next.js 使用 Intlayer。

    我可以使用数组作为内容声明吗?

    可以:在 Intlayer 中数组可以作为内容声明。介绍如何声明、翻译每一项,以及在组件中读取。

    如何构建字典?

    Intlayer 何时自动构建字典,如何用 CLI 手动触发构建,以及生成的文件写入到哪里。

    修复 CI/CD 中的 Intlayer 构建错误

    修复只在 CI/CD 中出现的 Server Components 渲染错误,确保 Intlayer 字典在构建阶段生成。

    使用 bun 时出现模块未找到错误

    修复在 Bun 中使用 Intlayer 时出现的「Cannot find package」错误,原因是 Bun 限制了 require() 的作用域,并给出解决配置。

    翻译时限制 Claude Code 的 token 消耗

    为什么用 Claude Code 翻译会消耗大量 token,Intlayer 的替代做法,以及如何复用你的 Claude 订阅进行翻译。

    如何自定义语言列表?

    在 intlayer.config.ts 中自定义 Intlayer 支持的语言列表,包括地区变体和默认语言。

    如何配置基于域名的路由?

    使用 Intlayer 的基于域名的路由,让每种语言使用独立域名,在 intlayer.config.ts 中配置,重定向自动处理。

    vite-env-only:Intlayer 中 node:fs 误报错误

    为什么在 Intlayer + React-Router + Vite 的组合中,vite-env-only 报告 `node:fs` 导入被拒绝,以及应如何处理。

    修复 Intlayer 中的 ESBuild 错误

    修复 Intlayer 构建过程中的 ESBuild 错误,通常是因为框架的打包插件缺失或配置不正确。

    如何从 Cookie / 头信息中获取语言环境?

    使用 Intlayer 从 cookie 或请求头中读取当前语言,在服务器或中间件中渲染正确的语言。

    IntlayerNode 类型。它是什么?

    什么是 IntlayerNode 类型?为什么我的字符串被转换为 IntlayerNode<string>?

    Intlayer 命令未定义

    修复「intlayer: command not found」错误:安装 CLI,通过包管理器运行,并检查 PATH。

    从 URL 获取的语言环境不正确

    修复 Next.js 中从 URL 读取到错误语言的问题(例如得到「about」而不是「en」),使用 Intlayer 预期的 [locale] 目录结构。

    节点类型可以组合吗?(例如一句话中包含多个复数)

    如何在 Intlayer 中通过组合节点类型,使用 insert() 或嵌套 plural() 在一句话中表达多个独立的复数变量。

    我遇到了与子包 @intlayer/* 相关的错误

    修复 @intlayer/* 子包版本不一致导致的错误:将所有 Intlayer 包统一到同一版本并清除缓存。

    Next.js 中带有 i18n 的静态渲染与动态渲染

    为什么 next-intl 的辅助函数会让 Next.js 的 i18n 路由变为动态渲染,以及如何让本地化页面保持静态渲染。

    我可以翻译 URL 路径吗?

    可以:Intlayer 能翻译 URL 路径,例如将 /about 变为 /zh/guanyu,通过按语言配置 URL 重写实现。

    修复 Intlayer 的「unknown command」错误

    修复 Intlayer CLI 的「unknown command」错误:检查命令名称、CLI 版本以及调用可执行文件的方式。

    可以在没有全局 provider 的情况下使用 Intlayer 吗?

    在不挂载 provider 的情况下读取 Intlayer 内容,语言环境如何在服务器和浏览器中解析,以及与 provider 的性能差异。