Pinyin-Pro 中文拼音转换工具详解

葛依励Kenway

于 2025-06-09 09:22:40 发布

阅读量342

点赞数 4

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_01035/article/details/148527593

Pinyin-Pro 中文拼音转换工具详解

pinyin-pro 中文转拼音、拼音音调、拼音声母、拼音韵母、多音字拼音、姓氏拼音、拼音匹配项目地址: https://gitcode.com/gh_mirrors/pi/pinyin-pro

项目概述

Pinyin-Pro 是一个功能强大的中文拼音转换工具库，它能够将汉字转换为拼音，并支持多种输出格式和功能扩展。该工具库特别适合需要处理中文拼音的开发者使用，无论是前端还是后端项目都能轻松集成。

核心功能

基础拼音转换

Pinyin-Pro 最基本的功能是将汉字转换为拼音：

import { pinyin } from 'pinyin-pro';
pinyin('汉语拼音'); // 输出: 'hàn yǔ pīn yīn'

支持三种音调输出形式：

带符号的拼音（默认）：hàn yǔ
数字音调：han4 yu3
无音调：han yu

拼音分解功能

Pinyin-Pro 不仅能输出完整拼音，还能分解出拼音的各个组成部分：

声母提取：

pinyin('汉语拼音', { pattern: 'initial' }); // 输出: 'h y p y'

韵母提取：

pinyin('汉语拼音', { pattern: 'final' }); // 输出: 'àn ǔ īn īn'

首字母提取：

pinyin('赵钱孙李', { pattern: 'first' }); // 输出: 'z q s l'

音调提取：

pinyin('汉语拼音', { pattern: 'num' }); // 输出: '4 3 1 1'

高级功能

多音字处理：

pinyin('好', { multiple: true }); // 输出: 'hǎo hào'

姓氏模式：

pinyin('我叫曾小贤', { mode: 'surname' }); // 输出: 'wǒ jiào zēng xiǎo xián'

非汉字过滤：

pinyin('汉sa语2拼音', { removeNonZh: true }); // 输出: 'hàn yǔ pīn yīn'

自定义拼音：

import { customPinyin } from 'pinyin-pro';
customPinyin({ '干一行行一行': 'gàn yī háng xíng yī háng' });

拼音匹配：

import { match } from 'pinyin-pro';
match('汉语拼音', 'hanyupinyin'); // 返回匹配成功的索引数组

安装与使用

安装方式

NPM 安装：

npm install pinyin-pro

Yarn 安装：

yarn add pinyin-pro

浏览器直接引入：

<script src="path/to/pinyin-pro.js"></script>

参数详解

pinyin(word, options) 方法接受两个参数：

word: 必填，需要转换的汉字字符串
options: 可选配置对象，包含以下属性：

| 参数 | 说明 | 类型 | 可选值 | 默认值 | |-------------|------------------------------|---------|---------------------------|----------| | pattern | 输出内容类型 | string | pinyin/initial/final/num/first | pinyin | | toneType | 音调显示方式 | string | symbol/num/none | symbol | | type | 输出格式 | string | string/array | string | | multiple | 是否显示多音字所有读音 | boolean | true/false | false | | mode | 拼音查找模式 | string | normal/surname | normal | | removeNonZh | 是否过滤非汉字字符 | boolean | true/false | false |