# @gluhar/i18n 中文文档

规范地址：https://npmcn.com/package/%40gluhar/i18n/

版本：6\.4\.1
npm 元数据更新时间：2026-11-16T12:45:22.076Z
中文译文更新时间：2026-11-16T16:52:29.923Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gluhar/i18n
原文对照：https://npmcn.com/package/%40gluhar/i18n/?lang=original
项目主页：https://github.com/gluharco/gluhar#readme
源码仓库：https://github.com/gluharco/gluhar

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：27.4 kB，11 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- peer 依赖：nuxt ^4\.6\.2
- 首次发布：2025-01-21T20:25:05.955Z
- 最新版本发布：2026-11-16T12:45:21.830Z
- 近 30 天下载量：3100（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：37（近 12 个月 26 个）

## 中文简介

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

## 安装

```sh
npm install @gluhar/i18n
```

也可以使用：`pnpm add @gluhar/i18n`、`yarn add @gluhar/i18n`、`bun add @gluhar/i18n`

## README

# `@gluhar/i18n`

[![npm version](https://img.shields.io/npm/v/my-module/latest.svg?style=flat&colorA=020420&colorB=00DC82)](https://npmjs.com/package/my-module) [![npm downloads](https://img.shields.io/npm/dm/my-module.svg?style=flat&colorA=020420&colorB=00DC82)](https://npmjs.com/package/my-module) [![License](https://img.shields.io/npm/l/my-module.svg?style=flat&colorA=020420&colorB=00DC82)](https://npmjs.com/package/my-module) [![Nuxt](https://img.shields.io/badge/Nuxt-020420?logo=nuxt.js)](https://nuxt.com/)

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

[QQ 发布注释](https://npmcn.com/CHANGELOG.md)

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

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

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

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

## 配置 - `config/i18n.config.ts`

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

```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`。 。 。 .

## 使用量

```ts
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`。 。 。 .

## 捐款

地方发展

```bash
# 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 是什么？

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 和提交记录判断。

