# chinese-simple2traditional

> 中文繁简体互换，支持node端、浏览器端。

Latest version **2.3.2** (published 2026-02-07) · MIT license · 0 weekly downloads

## Install

```sh
npm install chinese-simple2traditional
pnpm add chinese-simple2traditional
yarn add chinese-simple2traditional
bun add chinese-simple2traditional
```

## Health

**Score 65/100 (B)** — status: stable.

Positive: has types; esm support; no vulnerabilities; has provenance; high quality score.

Warnings: low downloads.

## Facts

| | |
|---|---|
| Version | 2.3.2 |
| Published | 2026-02-07 |
| First published | 2021-12-21 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | ESM + CommonJS |
| Dependencies | 0 |
| Unpacked size | 951.8 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Provenance | attested (GitHub Actions) |
| Author | pengzhanbo |
| Maintainers | pengzhanbo |
| Keywords | 中文, 简体, 繁体, 繁简体, 繁简体转换, chinese, chinese simple, chinese traditional |

## Links

- npm: https://www.npmjs.com/package/chinese-simple2traditional
- Repository: https://github.com/pengzhanbo/chinese-simple2traditional
- Issues: https://github.com/pengzhanbo/chinese-simple2traditional/issues
- npm.io page: https://npm.io/package/chinese-simple2traditional

## Recent versions

- 2.3.2 (latest) — 2026-02-07
- 2.3.1 — 2026-02-06
- 2.3.0 — 2025-11-26
- 2.2.2 — 2024-05-11
- 2.2.1 — 2024-04-30
- 2.2.0 — 2024-04-27
- 2.1.0 — 2024-03-29
- 2.0.0 — 2024-03-23
- 1.2.0 — 2023-06-10
- 1.1.0 — 2022-12-11
- 1.0.1 — 2022-01-24
- 1.0.0 — 2021-12-21

## README

# 中文繁简体转换

![jsr](https://jsr.io/badges/@raise/han-convert)
![jsr score](https://jsr.io/badges/@raise/han-convert/score)

![NPM Version](https://img.shields.io/npm/v/chinese-simple2traditional)
![NPM Downloads](https://img.shields.io/npm/dy/chinese-simple2traditional)
![npm package minimized gzipped size](https://img.shields.io/bundlejs/size/chinese-simple2traditional?label=gzip)
![NPM License](https://img.shields.io/npm/l/chinese-simple2traditional)
![GitHub issue custom search](https://img.shields.io/github/issues-search?query=repo%3Apengzhanbo%2Fchinese-simple2traditional%20is%3Aissue%20is%3Aopen%20&logo=github&label=issue%20open)

- 内置字库，零依赖，支持任何运行环境。
- 支持 `3077+` 常用简体字 和 `4919+` 繁体字/异体字。
- 支持 `3577+` 简体短语转繁体的特殊情况。
- 支持 `117+` 繁体短语/异体短语 转简体的特殊情况。

内置字库 `< 30kb`，短语库 约 `374kb`。为了避免加载资源过多，你需要手动加载短语库。

`v2` 相比于 `v1` 版本，提供了更多的字库支持！更精确的繁简体转换！更少的转换耗时！

> [!IMPORTANT]
> `v2` 版本仅支持 ESM 导入，不再支持 CommonJS 和 IIFE。
>
> 如果你想使用 CommonJS 或 IIFE 导入，请使用 `v1` 版本。

## 预览

访问 [在线演示](https://han-convert.netlify.app/) 查看。

``` sh
# npm
npm install chinese-simple2traditional
# yarn
yarn add chinese-simple2traditional
# pnpm
pnpm add chinese-simple2traditional
```

也可以使用 JSR ，但包名重命名为 `@raise/han-convert`：

```sh
# npm
npx jsr add @raise/han-convert
# yarn
yarn dlx jsr add @raise/han-convert
# pnpm
pnpm dlx jsr add @raise/han-convert
# bun
bunx jsr add @raise/han-convert
# deno
deno add jsr:@raise/han-convert
```

## Usage

``` js
import { toSimplified, toTraditional } from 'chinese-simple2traditional'

toTraditional('主人何为言少钱，径须酤取对君酌。') // 主人何爲言少錢，徑須酤取對君酌

toSimplified('主人何爲言少錢，徑須酤取對君酌') // 主人何为言少钱，径须酤取对君酌。
```

默认情况下，繁简体转换仅是逐个对字符进行处理，因此获取的结果可能并不是精确的。
优势是加载的包体积 `<30kb`。

你还可以额外引入 短语库，获取更为精确的转换结果，但需要额外加载 `374kb+` 的短语库。

```js
import { toSimplified, toTraditional } from 'chinese-simple2traditional'
import { setupEnhance } from 'chinese-simple2traditional/enhance'

setupEnhance() // 注入短语库

// 默认情况下，王后 被错误转为 王後
toSimplified('王妃后来成为了王后') // 王妃後來成爲了王後
// 传入第二个参数 `true` 以获取精确结果
toSimplified('王妃后来成为了王后', true) // 王妃後來成爲了王后
```

如果是使用 JSR 安装，请使用以下语句导入：

```js
import { toSimplified, toTraditional } from '@raise/han-convert'
import { setupEnhance } from '@raise/han-convert/enhance'
```

## API

### toSimplified(text[, enhance])

- `text`: `string`， 待转换的文本
- `enhance`: `boolean`， 是否启用短语库，只有在 注入短语库 后有效

将文本简体转换为繁体。

### toTraditional(text[, enhance])

- `text`: `string`， 待转换的文本
- `enhance`: `boolean`， 是否启用短语库，只有在 注入短语库 后有效

将文本繁体转换为简体。

### setupEnhance()

注入短语库。

```js
import { setupEnhance } from 'chinese-simple2traditional/enhance'
```

如果是使用 JSR 安装，请使用以下语句导入：

```js
import { setupEnhance } from '@raise/han-convert/enhance'
```

### customS2TPhrases(phrases)

添加 自定义 简体转繁体 短语集合。

- `phrases`: `[string, string][]` ， 短语集合

  集合的每个元素为 `['简体短语', '繁体短语']` 的元组，表示 `简体短语` 转换为 `繁体短语`

```ts
import { customS2TPhrases, toTraditional } from 'chinese-simple2traditional'

customS2TPhrases([
  ['双台子区', '雙臺子區'],
  // ...
])

toTraditional('双台子区', true) // 雙臺子區
```

### customT2SPhrases(phrases)

添加 自定义 繁体转简体 短语集合。

- `phrases`: `[string, string][]` ， 短语集合

  集合的每个元素为 `['繁体短语', '简体短语']` 的元组, 表示 `繁体短语` 转换为 `简体短语`

```ts
import { customT2SPhrases, toSimplified } from 'chinese-simple2traditional'

customT2SPhrases([
  ['雖覆能復', '虽覆能复']
  // ...
])

toSimplified('雖覆能復', true) // 虽覆能复
```

## LICENSE

[MIT](./LICENSE)

---
_Source: https://npm.io/package/chinese-simple2traditional · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._