@gluhar/i18n

中文文档
6.4.1发布于 2026/11/16MITTypeScriptES Module近 30 天下载 3100

Gluhar i18n (国际化) 软件包. 在引擎盖下配置 vue-i18n. 供货商可进行堆肥,例如使用Messages和SEO utils.

中文使用文档
文档目录5 节
  1. I18n如何在克卢哈尔项目中工作
  2. 配置 - config/i18n.config.ts
  3. 默认
  4. 使用量
  5. 捐款

@gluhar/i18n

npm version npm downloads License Nuxt

Gluhar i18n 软件包. 安装和配置 @nuxtjs/i18n 从一个工程文件,并提供 useMessages 键.

QQ 发布注释

I18n如何在克卢哈尔项目中工作

有两种文字,它们从不混合:

它的栖息地点读取
用户界面字符串 (按钮、标签、错误)lang/<code>.json,随建筑一起运出t("key")
内容 (任何编辑写作)卫生,本地化 每个字段 (单位:千美元)localeString, (中文(简体) ), localeText, (中文(简体) ), localeBlock(中文(简体) )l(field)

UI 字符串不在 Sanity 中被编写 。 镜像工作室文档 lang/*.json 是真理的第二个来源和两个漂移——v6被移除 loadMessages 编辑 Translations 类型.

配置 - config/i18n.config.ts

当地人唯一的真相来源. 工作室也导入了它,所以保持一个平坦的静态模块.

export const locales = [
  { code: "bg", language: "bg-BG", name: "Български" },
  { code: "en", language: "en-GB", name: "English" },
] as const;
export const defaultLocale = "bg";
// Optional. Locale t() falls back to for a missing key. Default: defaultLocale.
export const fallbackLocale = "en";

as const 需要: LangCode 从中键入。 永远不要在任何地方写一个地语编码(路由规则,站点地图排除,重定向)——来源于 locales 编号 : defaultLocale。哪个地方是默认变化的频率比你想象的要多.

信件输入 lang/<code>.json (记名键是好的). 键从 默认 语言文件,所以 t("missing.key") 是类型错误.

默认

  • strategy: "prefix_except_default" ——默认的地块没有前缀,其他的都是 /<code>/…。 。 。 .
  • detectBrowserLanguage: false - 饼干驱动302开 / 无法与 ISR- crashed HTML 工作,并与hreflang相矛盾. 取出语言者为开关.
  • fallbackLocale 通过生成 vue-i18n 配置应用。 要完全接管 vue-i18n 配置,添加 i18n/i18n.config.ts (单位:千美元)defineI18nConfig它胜过创造者.

已解决的选项写入 nuxt.options.i18n,所以读取回 i18n 配置的模块(@nuxtjs/sitemap, nuxt-seo),参见真实的当地人. 不要在顶层镜像配置 i18n 键 ——v5项目做了这个工作;v6项目重复了每个地方. 其它 @nuxtjs/i18n 选项(例如). baseUrl进去 gluhar.i18n 或顶层 i18n 键 - 只是不 locales。 。 。 .

使用量

const { t, l, locale } = useMessages();

t("form.submit");                  // typed key from lang/<default>.json
t("plan.symmetric", { speed: 500 }); // fills "[speed]"; unfilled [x] are removed
l(page.title);                      // { bg, en } → the active locale's value

l() 已经 无后退:只用一种语言填入的字段使另一种语言空出.

类型 : LocaleString, (中文(简体) ), LocaleBlocks, (中文(简体) ), LocaleField<V> (从 @gluhar/i18n/types 以及产生的全球效应 LangCode 财务报告和审定财务报表 MessageKey。 。 。 .

捐款

地方发展
# Install dependencies
npm install

# Generate type stubs
npm run dev:prepare

# Develop with the playground
npm run dev

# Build the playground
npm run dev:build

# Run ESLint
npm run lint

# Run Vitest
npm run test
npm run test:watch

# Release new version
npm run release

版本与发布记录

@gluhar/i18n 共发布 37 个版本,首次发布于 2025/01/22;过去 12 个月发布了 26 个版本。

版本发布日期距今
6.4.1latest2026/11/16今天
6.4.02026/11/16今天
6.3.22026/11/161 天前
6.3.12026/11/151 天前
6.3.02026/11/151 天前
6.2.02026/11/151 天前

其他发布通道:dev → 3.0.1-dev.2,next → 6.0.0-next.12。

关于 @gluhar/i18n 的常见问题

@gluhar/i18n 是什么?

Gluhar i18n (国际化) 软件包. 在引擎盖下配置 vue-i18n. 供货商可进行堆肥,例如使用Messages和SEO utils.

如何安装 @gluhar/i18n?

在项目目录运行 npm install @gluhar/i18n,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:nuxt(^4.6.2)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@gluhar/i18n 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@gluhar/i18n 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@gluhar/i18n 可以商用吗?

@gluhar/i18n 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@gluhar/i18n 的下载量有多少?

根据 npm 官方下载统计,@gluhar/i18n 在 2026/10/17 – 2026/11/15 这 30 天内被下载 3,100 次,日均约 103 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@gluhar/i18n 还在维护吗?

最新版本 6.4.1 发布于 2026/11/16(今天);至今共发布 37 个版本,其中过去 12 个月发布了 26 个;首次发布于 2025/01/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。