Skip to main content

中文繁简体转换, 内置字库,零依赖,支持任何运行时。

Works with
This package works with Bun
This package works with Cloudflare Workers
This package works with Node.js
This package works with Deno
This package works with Browsers
JSR Score
100%
Published
a week ago (2.2.2)

中文繁简体转换

jsr jsr score

NPM Version NPM Downloads npm package minimized gzipped size NPM License GitHub issue custom search

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

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

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

Important

v2 版本仅支持 ESM 导入,不再支持 CommonJS 和 IIFE。

预览

访问 在线演示 查看。

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

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

# 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 @raise/han-convert

Usage

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

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

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

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

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

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

setupEnhance() // 注入短语库

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

如果是使用 JSR 安装,请使用以下语句导入:

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()

注入短语库。

import { setupEnhance } from 'chinese-simple2traditional/enhance'
// or JSR
import { setupEnhance } from '@raise/han-convert/enhance'

customS2TPhrases(phrases)

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

  • phrases: [string, string][] , 短语集合

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

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

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

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

customT2SPhrases(phrases)

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

  • phrases: [string, string][] , 短语集合

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

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

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

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

LICENSE

MIT

Built and signed on
GitHub Actions
View transparency log

Add Package

deno add @raise/han-convert

Import symbol

import * as mod from "@raise/han-convert";

Add Package

npx jsr add @raise/han-convert

Import symbol

import * as mod from "@raise/han-convert";

Add Package

yarn dlx jsr add @raise/han-convert

Import symbol

import * as mod from "@raise/han-convert";

Add Package

pnpm dlx jsr add @raise/han-convert

Import symbol

import * as mod from "@raise/han-convert";

Add Package

bunx jsr add @raise/han-convert

Import symbol

import * as mod from "@raise/han-convert";