# @94ai-plus/common-locale 中文文档
规范地址：https://npmcn.com/package/%4094ai-plus/common-locale/
版本：1\.0\.0-beta\.1
npm 元数据更新时间：2026-11-05T08:59:43.254Z
中文译文更新时间：2026-11-06T19:11:58.463Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%4094ai-plus/common-locale
原文对照：https://npmcn.com/package/%4094ai-plus/common-locale/?lang=original
项目主页：https://oss.xccjh.top/common-ui-plus/index.html
源码仓库：http://gitlab.94ai.pro/ui/common-ui-plus
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：631 kB，92 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：vue ^3\.5\.44
- 首次发布：2026-10-29T08:30:43.582Z
- 最新版本发布：2026-11-05T08:59:43.004Z
- 近 30 天下载量：2440（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：10（近 12 个月 10 个）
## 中文简介
通用- ui- plus 语言运行时间
## 安装
```sh
npm install @94ai-plus/common-locale
```
也可以使用：`pnpm add @94ai-plus/common-locale`、`yarn add @94ai-plus/common-locale`、`bun add @94ai-plus/common-locale`
## README
# [ ](https://oss.xccjh.top/common-ui-plus/index.html)
[](https://www.npmjs.com/package/@94ai-plus/common-locale) [](https://nodejs.org/en/blog/release/v22.13.0) [](https://vuejs.org/) [](https://cdn.jsdelivr.net/npm/@94ai-plus/common-locale@1.0.0-beta.1/LICENSE) [](https://oss.xccjh.top/common-ui-plus-badges/test-pass-rate.svg) [](https://oss.xccjh.top/common-ui-plus-badges/coverage.svg)
[](https://www.npmjs.com/package/@94ai-plus/common-locale)
# @94ai-plus/common-locale
Common UI Plus 的 Vue 3 国际化运行时，提供中文、英文、日语、西语、印尼语、泰语、他加禄语、葡萄牙语语言包、响应式语言切换、语言注册和可选的 vue-i18n 适配器。
## [HomePage](https://oss.xccjh.top/common-ui-plus/index.html)
[官网](https://oss.xccjh.top/common-ui-plus/index.html) · [项目仓库](http://gitlab.94ai.pro/ui/common-ui-plus) · [全局配置](http://gitlab.94ai.pro/ui/common-ui-plus/-/blob/main/docs/components/fixture.md)
## Installation
```bash
yarn add @94ai-plus/common-locale vue
```
## Usage
在应用创建时注入上下文；使用 CommonUI 时，也可通过 `createCommonUI({ locale })` 完成注入。
```ts
import { createApp } from 'vue'
import { createLocale, installLocale, zhCn } from '@94ai-plus/common-locale'
import App from './App.vue'
const app = createApp(App)
const locale = createLocale(zhCn)
installLocale(app, locale)
app.mount('#app')
```
组件内使用：
```vue
```
- `createLocale()` 默认中文，内置 `zh-CN`、`en-US`、`ja`、`es`、`id`、`th`、`tl`、`pt`；通过 `registerLanguage({ name, messages })` 注册其他语言。
- 总入口具名导出 `zhCn`、`enUs`、`ja`、`es`、`id`、`th`、`tl`、`pt`。语言包也可从 `@94ai-plus/common-locale/zh-cn`、`/en-us`、`/ja`、`/es`、`/id`、`/th`、`/tl`、`/pt` 默认导入，独立子路径可按需打包。
- `useLocale()` 读取当前应用注入的上下文；顶层导出的 `t()` 使用独立的默认上下文，不随某个应用的配置自动切换。
- `createVueI18nAdapter(composer)` 可配合已有 vue-i18n composer，再由 `installLocale` 注入，无需强制安装 vue-i18n。
- 本包不依赖 Element Plus，也不翻译任意按钮插槽内容。CommonUI 会为内置语言选择对应的 Element Plus 语言包，显式 `elementPlusLocale` 优先；他加禄语使用本仓库适配包。
## Contributors
感谢每一位参与项目建设的贡献者！
以上为随本版本发布的贡献者统计快照，统计日期与分支见图中说明；仅统计 Git 非合并提交，头像使用姓名首字母，不是 GitLab 个人照片。
## License
本项目采用 [MIT License](https://cdn.jsdelivr.net/npm/@94ai-plus/common-locale@1.0.0-beta.1/LICENSE) 开源许可。
Copyright (c) 2026-present Jiahe Zou, 94 Intelligent Technology Co., Ltd.
## 常见问题
### @94ai-plus/common-locale 是什么？
通用- ui- plus 语言运行时间
### 如何安装 @94ai-plus/common-locale？
在项目目录运行 npm install @94ai-plus/common-locale，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vue（^3\.5\.44）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
### @94ai-plus/common-locale 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
### @94ai-plus/common-locale 支持 ESM 还是 CommonJS？
同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。
### @94ai-plus/common-locale 可以商用吗？
@94ai-plus/common-locale 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @94ai-plus/common-locale 的下载量有多少？
根据 npm 官方下载统计，@94ai-plus/common-locale 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,440 次，日均约 81 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @94ai-plus/common-locale 还在维护吗？
最新版本 1\.0\.0-beta\.1 发布于 2026/11/05（2 天前）；至今共发布 10 个版本，其中过去 12 个月发布了 10 个；首次发布于 2026/10/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。