# @ecomplus/i18n 中文文档

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

版本：1\.32\.2
npm 元数据更新时间：2022-09-27T09:54:44.920Z
中文译文更新时间：2026-11-13T05:58:44.749Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.4 MB，24 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2019-11-07T00:56:53.865Z
- 最新版本发布：2022-09-27T09:54:44.841Z
- 近 30 天下载量：4182（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 0 个）

## 中文简介

用于电子商务的可动摇树词典

## 安装

```sh
npm install @ecomplus/i18n
```

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

## README

# i18n (英语)

[![Publish](https://github.com/ecomplus/i18n/workflows/Publish/badge.svg)](https://github.com/ecomplus/i18n/actions?workflow=Publish) [![npm version](https://img.shields.io/npm/v/@ecomplus/i18n.svg)](https://www.npmjs.org/@ecomplus/i18n) [![License MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

:brazil:我们:

树木摇摆词典专注于eCommerce JS应用.

> `i18n` ~ (法语) `i19` ~ 国际化

## 开始

```bash
npm i --save @ecomplus/i18n
```

### 使用量

```js
import { i19hello, i19visitor } from '@ecomplus/i18n'
console.log(`${i19hello.en_us} ${i19visitor.pt_br}`)
// Hello Visitor
console.log(`${i19hello.pt_br} ${i19visitor.pt_br}`)
// Olá Visitante
```

我们建议用它 [`ecomUtils.i18n`](https://developers.e-com.plus/utils/ecomUtils.html#.i18n)数字 :

```js
import { i18n } from '@ecomplus/utils'
import { i19hello, i19visitor } from '@ecomplus/i18n'
console.log(`${i18n(i19hello)} ${i18n(i19visitor)}`)
// Hello Visitor
```

更改当前语言 `ecomUtils._config`数字 :

```js
import { _config, i18n } from '@ecomplus/utils'
import { i19hello, i19visitor } from '@ecomplus/i18n'
_config.set('lang', 'pt_br')
console.log(`${i18n(i19hello)} ${i18n(i19visitor)}`)
// Olá Visitante
```

#### 导入整个字典对象

它会输出出大尺寸的捆绑, _对前端的应用程序不好_。 。 。 .

```js
import dictionary from '@ecomplus/i18n'
console.log(`${dictionary.i19hello.en_us} ${dictionary.i19visitor.en_us}`)
// Hello Visitor
```

### Web 包装别名

您只能使用 [网络软件包 `resolve.alias`](https://webpack.js.org/configuration/resolve/#resolvealias) 现改为:

```js
// webpack.config.js
module.exports = {
  //...
  resolve: {
    alias: {
      '@ecomplus/i18n$': `@ecomplus/i18n/src/${lang}/`
    }
  }
}
```

**这样你只导入字符串而不是对象**数字 :

```js
import { i19hello, i19visitor } from '@ecomplus/i18n'
console.log(`${i19hello} ${i19visitor}`)
// Hello Visitor
```

你还可以用 [`ecomUtils.i18n`](https://developers.e-com.plus/ecomplus-utils/ecomUtils.html#.i18n) 同样的方式:

```js
import { i18n } from '@ecomplus/utils'
import { i19hello, i19visitor } from '@ecomplus/i18n'
console.log(`${i18n(i19hello)} ${i18n(i19visitor)}`)
// Hello Visitor
```

## 公约

1.  字符串值总是使用 **大写后的第一个字母** (例如: `'Hello'`(三);
2.  变量( E)`const`姓名总是用英文;
3.  **前缀 `i19`** 所有可变名称;
4.  字符串变量必须是 _骆驼_ (例如: `i19helloWorld`(三);
5.  对象( enum) 变量必须是 _帕斯卡凯德_ (例如: `i19OrderStatus`(三);
6.  **所有语言选项都必须有相同的变量**· ;
7.  对于长信息:变量名称应后缀为 `Msg`· ;
8.  问题:可变名称应后缀 `Qn`· ;

### 代码样式

9.  导出常数必须按字母顺序排列;
10.  对象前的额外换行符(不是字符串);

## 常见问题

### @ecomplus/i18n 是什么？

用于电子商务的可动摇树词典

### 如何安装 @ecomplus/i18n？

在项目目录运行 npm install @ecomplus/i18n，或使用 pnpm add / yarn add / bun add。

### @ecomplus/i18n 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/ecomplus\_\_i18n 是否存在。

### @ecomplus/i18n 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @ecomplus/i18n 可以商用吗？

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

### @ecomplus/i18n 的下载量有多少？

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

### @ecomplus/i18n 还在维护吗？

最新版本 1\.32\.2 发布于 2022/09/27（4 年前）；至今共发布 43 个版本，其中过去 12 个月发布了 0 个；首次发布于 2019/11/07。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。