hmoban 一个超级好玩的Python库
Python 中提供了汉字转拼音的库，名字叫做 PyPinyin，可以用于汉字注音、排序、检索等等场合，是基于 hotto/pinyin 这个库开发的。
它有这么几个特性：
根据词组智能匹配最正确的拼音。
支持多音字。
简单的繁体支持, 注音支持。
支持多种不同拼音/注音风格。
是不是等不及了呢？那就让我们来了解一下它的用法吧！
安装
首先就是这个库的安装了，通过 pip 安装即可：
pip3 install pypinyin
安装完成之后导入一下这个库，如果不报错，那就说明安装成功了。
>>> import pypinyin
好，接下来我们看下它的具体功能。
基本拼音
首先我们进行一下基本的拼音转换，方法非常简单，直接调用 pinyin 方法即可：
from pypinyin import pinyin
print(pinyin('中心'))
运行结果：
[['zhōng'], ['xīn']]
可以看到结果会是一个二维的列表，每个元素都另外成了一个列表，其中包含了每个字的读音。
那么如果这个词是多音字咋办呢？比如 “朝阳”，它有两个读音，我们拿来试下：
from pypinyin import pinyin
print(pinyin('朝阳'))
运行结果：
[['zhāo'], ['yáng']]
好吧，它只给出来了一个读音，但是如果我们想要另外一种读音咋办呢？
其实很简单，只需添加 heteronym 参数并设置为 True 就好了，我们试下：
from pypinyin import pinyin
print(pinyin('朝阳', heteronym=True))
运行结果：
[['zhāo', 'cháo'], ['yáng']]
OK 了，这下子就显示出来了两个读音了，而且我们也明白了结果为什么是一个二维列表，因为里面的一维的结果可能是多个，比如多音字的情况就是这样。
但这个多少解析起来有点麻烦，很多情况下我们是不需要管多音字的，我们只是用它来转换一下名字而已，而处理上面的二维数组又比较麻烦。
所以有没有一个方法直接给我们一个一维列表呢？有！
我们可以使用 lazy_pinyin 这个方法来生成，尝试一下：
from pypinyin import lazy_pinyin
print(lazy_pinyin('聪明的小兔子'))
运行结果：
['cong', 'ming', 'de', 'xiao', 'tu', 'zi']
这时候观察到得到的是一个列表，并且不再包含音调了。
这里我们就有一个疑问了，为啥 pinyin 方法返回的结果默认是带音调的，而 lazy_pinyin 是不带的，这里面就涉及到一个风格转换的问题了。
风格转换
我们可以对结果进行一些风格转换，比如不带声调风格、标准声调风格、声调在拼音之后、声调在韵母之后、注音风格等等，比如我们想要声调放在拼音后面，可以这么来实现：
from pypinyin import lazy_pinyin, Style
style = Style.TONE3
print(lazy_pinyin('聪明的小兔子', style=style))
运行结果：
['cong1', 'ming2', 'de', 'xiao3', 'tu4', 'zi']
可以看到运行结果每个拼音后面就多了一个声调，这就是其中的一个风格，叫做 TONE3，其实还有很多风格，下面是我从源码里面找出来的定义：
#: 普通风格，不带声调。如： 中国 -> ``zhong guo`` NORMAL = 0 #: 标准声调风格，拼音声调在韵母第一个字母上（默认风格）。如： 中国 -> ``zhōng guó`` TONE = 1 #: 声调风格2，即拼音声调在各个韵母之后，用数字 [1-4] 进行表示。如： 中国 -> ``zho1ng guo2`` TONE2 = 2 #: 声调风格3，即拼音声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> ``zhong1 guo2`` TONE3 = 8 #: 声母风格，只返回各个拼音的声母部分（注：有的拼音没有声母，详见 `#27`_）。如： 中国 -> ``zh g`` INITIALS = 3 #: 首字母风格，只返回拼音的首字母部分。如： 中国 -> ``z g`` FIRST_LETTER = 4 #: 韵母风格，只返回各个拼音的韵母部分，不带声调。如： 中国 -> ``ong uo`` FINALS = 5 #: 标准韵母风格，带声调，声调在韵母第一个字母上。如：中国 -> ``ōng uó`` FINALS_TONE = 6 #: 韵母风格2，带声调，声调在各个韵母之后，用数字 [1-4] 进行表示。如： 中国 -> ``o1ng uo2`` FINALS_TONE2 = 7 #: 韵母风格3，带声调，声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> ``ong1 uo2`` FINALS_TONE3 = 9 #: 注音风格，带声调，阴平（第一声）不标。如： 中国 -> ``ㄓㄨㄥ ㄍㄨㄛˊ`` BOPOMOFO = 10 #: 注音风格，仅首字母。如： 中国 -> ``ㄓ ㄍ`` BOPOMOFO_FIRST = 11 #: 汉语拼音与俄语字母对照风格，声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> ``чжун1 го2`` CYRILLIC = 12 #: 汉语拼音与俄语字母对照风格，仅首字母。如： 中国 -> ``ч г`` CYRILLIC_FIRST = 13
有了这些，我们就可以轻松地实现风格转换了。
好，再回到原来的问题，为什么 pinyin 的方法默认带声调，而 lazy_pinyin 方法不带声调，答案就是：它们二者使用的默认风格不同，我们看下它的函数定义就知道了：
pinyin 方法的定义如下：
def pinyin(hans, style=Style.TONE, heteronym=False, errors='default', strict=True)
lazy_pinyin 方法的定义如下：
def lazy_pinyin(hans, style=Style.NORMAL, errors='default', strict=True)
错误处理
在这里我们先做一个测试，比如我们传入无法转拼音的字，比如：
from pypinyin import lazy_pinyin
print(lazy_pinyin('你好☆☆，我是xxx'))
其中包含了星号两个，还有标点一个，另外还包含了一个 xxx 英文字符，结果会是什么呢？
['ni', 'hao', '☆☆，', 'wo', 'shi', 'xxx']
可以看到结果中星号和英文字符都作为一个整体并原模原样返回了。
那么这种特殊字符可以单独进行处理吗？当然可以，这里就用到刚才提到的 errors 参数了。
errors 参数是有几种模式的：
default：默认行为，不处理，原木原样返回
ignore：忽略字符，直接抛掉
replace：直接替换为去掉 u 的 unicode 编码
callable 对象：当传入一个可调用的对象的时候，则可以自定义处理方式。
下面是 errors 这个参数的源码实现逻辑：
def _handle_nopinyin_char(chars, errors='default'):
"""处理没有拼音的字符"""
if callable_check(errors):
return errors(chars)
if errors == 'default':
return chars
elif errors == 'ignore':
return None
elif errors == 'replace':
if len(chars) > 1:
return ''.join(text_type('%x' % ord(x)) for x in chars)
else:
return text_type('%x' % ord(chars))
自定义拼音
如果对库返回的结果不满意，我们还可以自定义自己的拼音库，这里用到的方法就有 load_single_dict 和 load_phrases_dict 方法了。
比如刚才我们看到 “朝阳” 两个字的发音默认返回的是 zhao yang，我们想默认返回 chao yang，那可以这么做：
from pypinyin import lazy_pinyin, load_phrases_dict
print(lazy_pinyin('朝阳'))
personalized_dict = {
'朝阳': [['cháo'], ['yáng']]
}
load_phrases_dict(personalized_dict)
print(lazy_pinyin('朝阳'))
这里我们自定义了一个词典，然后使用 load_phrases_dict 方法设置了一下就可以了。
运行结果：
2 ['zhao', 'yang'] ['chao', 'yang']
这样就可以完成自定义的设置了。
在一些项目里面我们可以自定义很多拼音库，然后加载就可以了。
另外我们还可以注册样式实现自定义，比如将某个拼音前面加上 Emoji 表情，样例：
from pypinyin.style import register
from pypinyin import lazy_pinyin
@register('kiss')
def kiss(pinyin, **kwargs):
if pinyin == 'me':
return f'{pinyin}'
return pinyin
print(lazy_pinyin('么么哒', style='kiss'))
运行结果：
['me', 'me', 'dá']
来源：PY学习网：原文地址：https://www.py.cn/article.html