Python中的中文拼音转换库：pypinyin与xpinyin

在Python中，将中文字符转换为拼音是一个常见的需求，特别是在文本处理、自然语言处理或者开发拼音学习工具时。为了满足这一需求，开发者们推出了多个库，其中pypinyin和xpinyin是两个比较流行的选择。下面，我们将分别介绍这两个库的基本用法。

pypinyin库

pypinyin是一个用于将汉字转换为拼音的Python库，它支持多音字、声调以及多种拼音风格。官方文档：汉字拼音转换工具（Python 版） — pypinyin 0.51.0 文档https://pypinyin.readthedocs.io/zh-cn/master/

安装

你可以使用pip来安装pypinyin：

pip install pypinyin

基本用法

import pypinyin

text_list = ['北京', '朝阳', '战略']

# 将中文字符串转换为拼音的slug（即不带声调和分隔符的连续小写字符串）
pinyin = pypinyin.slug(text_list[1])
print(pinyin)
pinyin = pypinyin.slug(text_list[2])
print(pinyin)
pinyin1 = pypinyin.slug(text_list, heteronym=True)   # 启用多音字模式
print(pinyin1)

# 将每个汉字转换为拼音（一个词语会分割成多个字逐个转换）
pinyin2 = pypinyin.pinyin(text_list)
print(pinyin2)
pinyin3 = pypinyin.pinyin(text_list, heteronym=True)   # 启用多音字模式
print(pinyin3)

# 将列表中的每个字符串转换为拼音 
pinyin4 = pypinyin.lazy_pinyin(text_list)
print(pinyin4)

运行结果：

拼音风格

除了转换为正常的拼音以外，还可以设置拼音风格，具体用法如下：

from pypinyin import Style
# 首字母风格，只返回拼音的首字母部分。
print(pypinyin.pinyin(text_list, style=Style.FIRST_LETTER))
# 声调风格2，即拼音声调在各个韵母之后，用数字 [1-4] 进行表示。
print(pypinyin.pinyin(text_list, style=Style.TONE2, heteronym=True))
# 声调风格3，即拼音声调在各个拼音之后，用数字 [1-4] 进行表示。
print(pypinyin.pinyin(text_list, style=Style.TONE3, heteronym=True))
# 注音风格，带声调，阴平（第一声）不标。
print(pypinyin.pinyin(text_list, style=Style.BOPOMOFO))

运行结果如下：

具体更多的用法可以去官方文档看一下，里面有详细的介绍。

xpinyin库

xpinyin是另一个拼音转换库，它的特点是支持拼音的自定义风格以及详细的分词功能。官方文档：xpinyin · PyPITranslate Chinese hanzi to pinyin (拼音) by Python, 汉字转拼音https://pypi.org/project/xpinyin/

安装

你可以使用pip来安装xpinyin：

pip install xpinyin

基本用法

获取汉字的拼音：

from xpinyin import Pinyin

p = Pinyin()
pinyin = p.get_pinyin('朝阳')
print(pinyin)
pinyin1 = p.get_pinyin('朝阳', tone_marks='marks')
print(pinyin1)
pinyin2 = p.get_pinyin("朝阳", tone_marks='numbers')
print(pinyin2)
pinyin3 = p.get_pinyin("朝阳", '')
print(pinyin3)
pinyin4 = p.get_pinyin("朝阳", ' ')
print(pinyin4)

运行结果：

下面列举几种其他的用法，大家看一下代码和运行结果就懂了，这里我就不介绍了。

print(p.get_initial("朝"))  # 运行结果：Z
print(p.get_initial("上"))  # 运行结果：S
​
print(p.get_initials("朝阳"))  # 运行结果：Z-Y
print(p.get_initials("朝阳", ''))  # 运行结果：ZY

​print(p.get_initials("朝阳", splitter='-', with_retroflex=True))  # 运行结果：ZH-Y
print(p.get_initials("上上", splitter='-', with_retroflex=True))  # 运行结果：SH-SH
print(p.get_initials("上海", splitter='-', with_retroflex=True))  # 运行结果：SH-H

注意：xpinyin库的具体功能和用法可能会根据版本的不同而有所变化，上述示例仅作参考。在使用时，请查阅官方文档或源码以获取最准确的信息。这里我的xpinyin库版本信息如下：

总结

pypinyin和xpinyin都是Python中用于汉字拼音转换的库，它们各有特点。pypinyin提供了丰富的拼音风格选项和多音字处理功能，而xpinyin可能更注重分词和自定义拼音风格。根据你的具体需求，你可以选择适合的库来进行开发。