快捷導(dǎo)航

Python pypinyin注音庫輕松絲滑實現(xiàn)漢字轉(zhuǎn)換成拼音

更新時間：2024年01月22日 09:15:25 作者：曉飛的李管窺程序

pypinyin 庫,能像功夫熊貓那樣,輕松、快捷地幫你把漢字轉(zhuǎn)換成拼音,有了 pypinyin,不僅可以節(jié)省寶貴的時間,還可以更準(zhǔn)確地展示中文字符的讀音,使文化交流更為順暢,本文帶大家一起探索 pypinyin 庫的魅力

引言

繼續(xù)我們的有趣的 Python 庫之旅 ——

一個小小的庫，或許能避免重復(fù)造輪子

一個不顯眼的功能，也許能在關(guān)鍵時刻拯救我們

一個出乎意料的方法，或許能激發(fā)更多創(chuàng)意靈感

一個獨特的技能，也許能成為我們的守護神……

想象一下，你需要把段文字轉(zhuǎn)換成拼音，以便讓上小學(xué)的孩子能讀懂?；蛘咭o一個名單的名字上加上拼音，以便國際友人可以讀出。手工轉(zhuǎn)換可能是一件耗時耗力的事情，特別是處理拼音中的音調(diào)時。

幸運的是，有一個神器，pypinyin 庫，能像功夫熊貓那樣，輕松、快捷地幫你把漢字轉(zhuǎn)換成拼音。

有了 pypinyin，不僅可以節(jié)省寶貴的時間，還可以更準(zhǔn)確地展示中文字符的讀音，使文化交流更為順暢。

現(xiàn)在，讓我們一起探索 pypinyin 庫的魅力所在吧！

什么是 pypinyin

pypinyin 是一個非常流行的 Python 庫，用于將漢字轉(zhuǎn)換為拼音。它可以根據(jù)漢字輸出對應(yīng)的拼音，并支持多音字和調(diào)式選項。

pypinyin 已經(jīng)在許多漢語處理項目中被廣泛使用，證明了它的實用性和穩(wěn)定性。它的出現(xiàn)大大簡化了處理中文數(shù)據(jù)的復(fù)雜性，提高了開發(fā)者工作的效率。

支持 Python 3.x 版本。

雖然還有其他一些庫提供類似的功能，例如 jieba 內(nèi)嵌有拼音轉(zhuǎn)換功能，但 pypinyin 以其專注高效的特點脫穎而出，并且由于它簡單易用而獲得青睞。

項目地址：https://github.com/mozillazg/python-pinyin

安裝

要開始使用 pypinyin，首先需要將它安裝到你的 Python 環(huán)境中。最簡單的方式是通過 pip 進行安裝。打開你的命令行終端，輸入以下命令：

pip install pypinyin

這行代碼就像施法咒語一樣，通過 Python 的包管理器 pip 幫你把 pypinyin 安裝好，準(zhǔn)備就緒！

基本用法

使用 pypinyin 非常直觀，函數(shù)調(diào)用簡單，讓我們通過一些示例代碼來看看它的基本用法。

首先，我們需要導(dǎo)入庫：

from pypinyin import pinyin, lazy_pinyin

以下是如何將一個漢字字符串轉(zhuǎn)換為拼音列表：

hanzi = '漢字轉(zhuǎn)拼音真方便！'
pinyin_list = pinyin(hanzi)
print(pinyin_list)

執(zhí)行結(jié)果：

[['hàn'], ['zì'], ['zhuǎn'], ['pīn'], ['yīn'], ['zhēn'], ['fāng'], ['biàn'], ['！']]

每個漢字的拼音被放在一個小列表里，多音字也能得到正確的拼音。

如果你只需要拼音字符串列表，而不是嵌套列表，可以使用 lazy_pinyin 方法：

pinyin_str_list = lazy_pinyin(hanzi)
print(pinyin_str_list)

執(zhí)行結(jié)果：

['han', 'zi', 'zhuan', 'pin', 'yin', 'zhen', 'fang', 'bian', '！']

多音字處理

對于多音字，pypinyin 還可以根據(jù)上下文智能識別正確的讀音：

sentence = '重陽節(jié)的重，和重量的重，讀音不一樣。'
for word in pinyin(sentence, heteronym=True):  # heteronym 參數(shù)啟用多音字模式 
    print(word)

執(zhí)行結(jié)果：

['chóng']
['yáng']
['jié', 'jiē']
['de', 'dī', 'dí', 'dì']
['zhòng', 'chóng', 'tóng']
['，']
['hé', 'hè', 'hú', 'huó', 'huò', 'huo']
['zhòng']
['liàng']
['de', 'dī', 'dí', 'dì']
['zhòng', 'chóng', 'tóng']
['，']
['dú']
['yīn']
['bù']
['yí']
['yàng']
['。']

拼音風(fēng)格

pypinyin 支持多種風(fēng)格的拼音呈現(xiàn)，比如 TONAL（帶聲調(diào)的拼音）， INITIALS（聲母）， NORMAL（不帶聲調(diào)的拼音），等等。就像是變化多端的變色龍，以適應(yīng)你的不同需求。

from pypinyin import Style

pinyin_initials = pinyin('拼音', style=Style.INITIALS, strict=False) # 聲母
print(pinyin_initials)

pinyin_normal = pinyin('拼音', style=Style.NORMAL) # 無聲調(diào)
print(pinyin_normal)

pinyin_tone = pinyin('拼音', style=Style.TONE) # 普通聲調(diào)
print(pinyin_tone)

pinyin_tone2 = pinyin('拼音', style=Style.TONE2) # 數(shù)字聲調(diào)
print(pinyin_tone2)

執(zhí)行結(jié)果：

[['p'], ['y']] # 聲母
[['pin'], ['yin']] # 無聲調(diào)
[['pīn'], ['yīn']] # 普通聲調(diào)
[['pi1n'], ['yi1n']]# 數(shù)字聲調(diào)

風(fēng)格為聲母 Style.INITIALS 時，不會顯示出 y，因為根據(jù) 《漢語拼音方案》， y，w，ü (yu) 都不是聲母，在某些特定韻母無聲母時，才加上 y 或 w，而 ü 也有其特定規(guī)則。

如果需要顯示，就將 strict 設(shè)置為 False，如上面例子所示。

定制拼音庫

如果你有特殊需求，比如某個漢字轉(zhuǎn)換為特定的拼音，pypinyin 支持定制拼音庫。你可以通過提供一個詞典來自定義讀音。

可以通過自定義詞組拼音庫或者單字拼音庫的方式修正拼音結(jié)果

from pypinyin import load_phrases_dict, load_single_dict

load_phrases_dict({'桔子': [['jú'], ['zǐ']]})  # 增加 "桔子" 詞組

load_single_dict({ord('還'): 'hái,huán'})  # 調(diào)整 "還" 字的拼音順序或覆蓋默認(rèn)拼音

也可以使用 pypinyin-dict 項目提供的自定義拼音庫來糾正結(jié)果。

# 使用 phrase-pinyin-data 項目中 cc_cedict.txt 文件中的拼音數(shù)據(jù)優(yōu)化結(jié)果
from pypinyin_dict.phrase_pinyin_data import cc_cedict
cc_cedict.load()

# 使用 pinyin-data 項目中 kXHC1983.txt 文件中的拼音數(shù)據(jù)優(yōu)化結(jié)果
from pypinyin_dict.pinyin_data import kxhc1983
kxhc1983.load()

CLI 命令行工具

除了在 Python 代碼中使用，pypinyin 還可以作為命令行工具使用：

$ pypinyin 音樂
yīn yuè
$ pypinyin -h

實踐

現(xiàn)在，來點兒實踐環(huán)節(jié)將更具有學(xué)習(xí)效果：

嘗試用 pypinyin 將一首中文詩歌轉(zhuǎn)換成拼音。
寫一個小工具，比如名字生成器，輸入中文名字，自動生成對應(yīng)的拼音。

請在下列代碼片段中補充你的實踐內(nèi)容：

# 將指定的中文詩歌轉(zhuǎn)換為拼音 
poem = '床前明月光，疑是地上霜。'
poem_pinyin = pinyin(poem)
print(poem_pinyin)

# 名字生成器 
def name_to_pinyin(name):
    # 補充代碼，返回姓名的拼音 
    return lazy_pinyin(name)

print(name_to_pinyin('張三'))