关注我的公众号:【编程朝花夕拾】,可获取首发内容。

01 引言
在Java开发中,处理中文拼音转换是常见却棘手的需求------无论是智能搜索、数据排序,还是拼音首字母检索。面对多音字、性能瓶颈、内存占用等问题,开发者该如何选择?
今天分享四种工具应对不同场景的汉字转拼音功能!
02 TinyPinyin
轻量级、高效的汉字转拼音库,不依赖任何外部词典文件。具有体积小(约60KB)、速度快、支持多音字(需词典)、支持拼音格式转换的特性。
2.2 Maven依赖
xml
<dependency>
<groupId>com.github.promeg</groupId>
<artifactId>tinypinyin</artifactId>
<version>2.0.3</version>
</dependency>
2.3 基本使用
java
@Test
void test01() {
Pinyin.init(Pinyin.newConfig().with(CnCityDict.getInstance()));
String pinyin = Pinyin.toPinyin("中国", " ");
System.out.println(pinyin); // ZHONG GUO
String pinyin1 = Pinyin.toPinyin('中');
System.out.println(pinyin1); // ZHONG
System.out.println(Pinyin.isChinese('中')); // true
System.out.println(Pinyin.isChinese('C')); // false
}
主要功能就是将汉字转成拼音,并通过指定的分隔符分开,还可以判断字符是否为汉字。功能非常简单,基本的汉字转拼音已经够用了。
多音字的处理需要定义自己的词典。我们看看内置的词典库CnCityDict

其实内部就是一个词典库,通过Map映射,我们可以自定义实现。
03 JPinyin
功能丰富的拼音转换工具,支持多音字、简繁体转换。
3.1 Maven依赖
xml
<dependency>
<groupId>com.github.stuxuhai</groupId>
<artifactId>jpinyin</artifactId>
<version>1.1.8</version>
</dependency>
3.2 基本使用
java
@Test
void test02() throws PinyinException {
// 转换为带声调拼音
String pinyin1 = PinyinHelper.convertToPinyinString(
"重庆银行", " ", PinyinFormat.WITH_TONE_MARK);
System.out.println(pinyin1); // zhòng qìng yín háng
// 转换为数字声调
String pinyin2 = PinyinHelper.convertToPinyinString(
"重庆银行", " ", PinyinFormat.WITH_TONE_NUMBER);
System.out.println(pinyin2); // zhong4 qing4 yin2 hang2
// 不带声调
String pinyin3 = PinyinHelper.convertToPinyinString(
"重庆银行", " ", PinyinFormat.WITHOUT_TONE);
System.out.println(pinyin3); // zhong qing yin hang
// 获取拼音首字母
String shortPinyin = PinyinHelper.getShortPinyin("你好精神小伙");
System.out.println(shortPinyin); // nhjsxh
// 检查是否为多音字
String[] duoyin = PinyinHelper.convertToPinyinArray('重');
for (String py : duoyin) {
System.out.println(py); // zhòng, chóng
}
}
该工具内置支持多音字,支持声调。
04 Pinyin4j
老牌的拼音转换库,功能全面但相对较重。
4.1 Maven依赖
xml
<dependency>
<groupId>com.belerweb</groupId>
<artifactId>pinyin4j</artifactId>
<version>2.5.1</version>
</dependency>
4.2 基本使用
java
@Test
void test03() throws BadHanyuPinyinOutputFormatCombination {
HanyuPinyinOutputFormat format = new HanyuPinyinOutputFormat();
// 配置输出格式
format.setToneType(HanyuPinyinToneType.WITHOUT_TONE); // 不带声调
format.setVCharType(HanyuPinyinVCharType.WITH_V); // 使用v表示ü
String[] duoyin = PinyinHelper.toHanyuPinyinStringArray('重', format);
for (String py : duoyin) {
System.out.println(py); // zhong, chong
}
String hanYuPinyinString = PinyinHelper.toHanYuPinyinString("中国国歌", format, " ", true);
System.out.println(hanYuPinyinString); // zhong guo guoge
String[] duoyin2 = PinyinHelper.toTongyongPinyinStringArray('重');
for (String py : duoyin2) {
System.out.println(py);// jhong4, chong2
}
}
Pinyin4j到目前位置已经9年没有更新了。支持声调、v与ü的表示。支持多音字,以及其他拼音系统。

05 HanLP
HanLP是一系列模型与算法组成的NLP工具包,目标是普及自然语言处理在生产环境中的应用。HanLP具备功能完善、性能高效、架构清晰、语料时新、可自定义的特点。其中汉字转拼音只是其中一个小工具。
5.1 Maven依赖
xml
<dependency>
<groupId>com.hankcs</groupId>
<artifactId>hanlp</artifactId>
<version>portable-1.8.6</version>
</dependency>
5.2 基础使用
java
@Test
void test04() {
List<Pinyin> list = HanLP.convertToPinyinList("重");
for (Pinyin pinyin : list) {
System.out.println(pinyin.getPinyinWithoutTone());
System.out.println(pinyin.getPinyinWithToneMark());
System.out.println(pinyin.getFirstChar());
System.out.println(pinyin.getShengmu());
System.out.println(pinyin.getYunmu());
System.out.println(pinyin.getTone());
System.out.println(pinyin.getHead());
System.out.println("-------------------");
}
String pinyinString = HanLP.convertToPinyinString("重载不是重任", " ", false);
System.out.println(pinyinString);
System.out.println(HanLP.convertToTraditionalChinese("用笔记本电脑写程序"));
System.out.println(HanLP.convertToSimplifiedChinese("「以後等妳當上皇后,就能買士多啤梨慶祝了」"));
}

HanLP可以将汉字转成Pinyin对象,然后可以获取拼音、声母、韵母、首字母、头信息等,还可以简繁体转化。虽然能在语义中识别多音字,但不能直接获取多音字的拼音。
06 小结
汉字转拼音虽是小功能,却直接影响用户体验和系统性能。本文分享的4款工具各有优缺点,可以应对不同的场景,大家可以根据需要选择。掌握这些框架,让中文处理不再是技术痛点,而是产品亮点。