image.png
pypinyin
将汉字转为拼音。可以用于汉字注音、排序、检索 。
- Documentation: http://pypinyin.rtfd.io
- GitHub: https://github.com/mozillazg/python-pinyin
特性
- 根据词组智能匹配最正确的拼音。
- 支持多音字。
- 简单的繁体支持, 注音支持。
- 支持多种不同拼音风格。
安装
$ pip install pypinyin
验证是否安装成功：
image.png
使用说明
>>> from pypinyin import pinyin, lazy_pinyin, Style
>>> pinyin('音乐')
[['yīn'], ['yuè']]
>>> pinyin('音乐', heteronym=True) #多音字
[['yīn'], ['yuè']]
>>> pinyin('乐', heteronym=True) #多音字
[['lè', 'yuè']]
>>> pinyin('乐')
[['lè']]
>>> lazy_pinyin('中心') #忽略多音字
['zhong', 'xin']
拼音风格
class pypinyin.Style定义拼音风格
| 风格 | 含义 |
|---|---|
| NORMAL = 0 | 普通风格，不带声调。如： 中国 -> zhong guo
|
| TONE = 1 | 标准声调风格，拼音声调在韵母第一个字母上（默认风格）。如： 中国 -> zhōng guó
|
| TONE2 = 2 | 声调风格2，即拼音声调在各个韵母之后，用数字 [1-4] 进行表示。如： 中国 -> zho1ng guo2
|
| TONE3 = 8 | 声调风格3，即拼音声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> zhong1 guo2
|
| INITIALS = 3 | 声母风格，只返回各个拼音的声母部分（注：有的拼音没有声母，详见 #27_）。如： 中国 -> zh g
|
| FIRST_LETTER = 4 | 首字母风格，只返回拼音的首字母部分。如： 中国 -> z g
|
| FINALS = 5 | 韵母风格，只返回各个拼音的韵母部分，不带声调。如： 中国 -> ong uo
|
| FINALS_TONE = 6 | 标准韵母风格，带声调，声调在韵母第一个字母上。如：中国 -> ōng uó
|
| FINALS_TONE2 = 7 | 韵母风格2，带声调，声调在各个韵母之后，用数字 [1-4] 进行表示。如： 中国 -> o1ng uo2
|
| FINALS_TONE3 = 9 | 韵母风格3，带声调，声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> ong1 uo2
|
| BOPOMOFO = 10 | 注音风格，带声调，阴平（第一声）不标。如： 中国 -> ㄓㄨㄥ ㄍㄨㄛˊ
|
| BOPOMOFO_FIRST = 11 | 注音风格，仅首字母。如： 中国 -> ㄓ ㄍ
|
| CYRILLIC = 12 | 汉语拼音与俄语字母对照风格，声调在各个拼音之后，用数字 [1-4] 进行表示。如： 中国 -> чжун1 го2
|
| CYRILLIC_FIRST = 13 | 汉语拼音与俄语字母对照风格，仅首字母。如： 中国 -> ч г
|
API函数
汉字转拼音
pinyin
pypinyin.pinyin(hans, style=<Style.TONE: 1>, heteronym=False, errors='default', strict=True)
将汉字转换为拼音，返回汉字的拼音列表。
| 参数 | 说明 |
|---|---|
| hans | 汉字字符串 |
| style | 指定拼音风格，默认是 TONE风格 |
| errors | 指定如何处理没有拼音的字符 |
| heteronym | 指定是否启用多音字 |
| strict | 指定是否严格遵照《汉语拼音方案》来处理声母和韵母 |
lazy_pinyin
pypinyin.lazy_pinyin(hans, style=<Style.NORMAL: 0>, errors='default', strict=True)
将汉字转换为拼音，返回不包含多音字结果的拼音列表.
| 参数 | 说明 |
|---|---|
| hans | 汉字字符串 |
| style | 指定拼音风格，默认是 TONE风格 |
| errors | 指定如何处理没有拼音的字符 |
| strict | 指定是否严格遵照《汉语拼音方案》来处理声母和韵母 |
自定义拼音库
load_single_dict
pypinyin.load_single_dict(pinyin_dict, style='default'
载入用户自定义的单字拼音库
| 参数 | 说明 |
|---|---|
| pinyin_dict (dict) | 单字拼音库。比如： {0x963F: u"ā,ē"} |
| style | pinyin_dict 参数值的拼音库风格. 支持 ‘default’, ‘tone2’ |
load_phrases_dict
pypinyin.load_phrases_dict(phrases_dict, style='default')
载入用户自定义的词语拼音库
| 参数 | 说明 |
|---|---|
| phrases_dict (dict) | 词语拼音库。比如： {u"阿爸": [[u"ā"], [u"bà"]]} |
| style | phrases_dict 参数值的拼音库风格. 支持 ‘default’, ‘tone2’ |
