Java汉字转拼音的四种方案，99%的开发场景都够用了！

01 引言

在Java开发中，处理中文拼音转换是常见却棘手的需求——无论是智能搜索、数据排序，还是拼音首字母检索。面对多音字、性能瓶颈、内存占用等问题，开发者该如何选择？

今天分享四种工具应对不同场景的汉字转拼音功能！

02 TinyPinyin

轻量级、高效的汉字转拼音库，不依赖任何外部词典文件。具有体积小（约60KB）、速度快、支持多音字（需词典）、支持拼音格式转换的特性。

2.2 Maven依赖

<dependency>
    <groupId>com.github.promeg</groupId>
    <artifactId>tinypinyin</artifactId>
    <version>2.0.3</version>
</dependency>

2.3 基本使用

@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依赖

<dependency>
    <groupId>com.github.stuxuhai</groupId>
    <artifactId>jpinyin</artifactId>
    <version>1.1.8</version>
</dependency>

3.2 基本使用

@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依赖

 <dependency>
    <groupId>com.belerweb</groupId>
    <artifactId>pinyin4j</artifactId>
    <version>2.5.1</version>
</dependency>

4.2 基本使用

@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与ü的表示。支持多音字，以及其他拼音系统。

地址：https://github.com/belerweb/pinyin4j

05 HanLP

HanLP是一系列模型与算法组成的NLP工具包，目标是普及自然语言处理在生产环境中的应用。HanLP具备功能完善、性能高效、架构清晰、语料时新、可自定义的特点。其中汉字转拼音只是其中一个小工具。

5.1 Maven依赖

<dependency>
    <groupId>com.hankcs</groupId>
    <artifactId>hanlp</artifactId>
    <version>portable-1.8.6</version>
</dependency>

5.2 基础使用

@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对象，然后可以获取拼音、声母、韵母、首字母、头信息等，还可以简繁体转化。虽然能在语义中识别多音字，但不能直接获取多音字的拼音。

地址：https://github.com/hankcs/HanLP/tree/1.x

06 小结

汉字转拼音虽是小功能，却直接影响用户体验和系统性能。本文分享的4款工具各有优缺点，可以应对不同的场景，大家可以根据需要选择。掌握这些框架，让中文处理不再是技术痛点，而是产品亮点。