Java實現(xiàn)漢字轉拼音的四種方案

更新時間：2025年12月26日 09:31:47 作者：SimonKing

在Java開發(fā)中,處理中文拼音轉換是常見卻棘手的需求,無論是智能搜索、數(shù)據(jù)排序,還是拼音首字母檢索,面對多音字、性能瓶頸、內存占用等問題,開發(fā)者該如何選擇,今天分享四種工具應對不同場景,需要的朋友可以參考下

01 引言

在Java開發(fā)中，處理中文拼音轉換是常見卻棘手的需求——無論是智能搜索、數(shù)據(jù)排序，還是拼音首字母檢索。面對多音字、性能瓶頸、內存占用等問題，開發(fā)者該如何選擇？

今天分享四種工具應對不同場景的漢字轉拼音功能！

02 TinyPinyin

輕量級、高效的漢字轉拼音庫，不依賴任何外部詞典文件。具有體積?。s60KB）、速度快、支持多音字（需詞典）、支持拼音格式轉換的特性。

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
}

主要功能就是將漢字轉成拼音，并通過指定的分隔符分開，還可以判斷字符是否為漢字。功能非常簡單，基本的漢字轉拼音已經(jīng)夠用了。

多音字的處理需要定義自己的詞典。我們看看內置的詞典庫CnCityDict

其實內部就是一個詞典庫，通過Map映射，我們可以自定義實現(xiàn)。

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


    // 轉換為數(shù)字聲調
    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到目前位置已經(jīng)9年沒有更新了。支持聲調、v與ü的表示。支持多音字，以及其他拼音系統(tǒng)。

05 HanLP

HanLP是一系列模型與算法組成的NLP工具包，目標是普及自然語言處理在生產環(huán)境中的應用。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("「以後等妳當上皇后，就能買士多啤梨慶祝了」"));
}