pypinyin: 汉字转换为拼音

安装：pip install pypinyin

直接上例子：

import pypinyin
from pypinyin import Style


# def pinyin(hans, style=Style.TONE, heteronym=False, errors='default', strict=True)
# 结果会是一个二维的列表，每个元素都另外成了一个列表，其中包含了每个字的读音（ pinyin 方法默认使用了 TONE 的风格，即有声调的风格模式）

word1 = pypinyin.pinyin('你好')
print(word1)
# [['nǐ'], ['hǎo']]

# -----------------------------------------------------

#  启用多音字模式
word2 = pypinyin.pinyin('朝阳', heteronym=True)
print(word2) 
# [['zhāo', 'cháo'], ['yáng']]

# 这里的多音词并不是指单个字的多音字，而是这个词语本身就有两种读音
word3 = pypinyin.pinyin('大夫', heteronym=True)
print(word3)
# [['dài'], ['fū']]; 此处就不会输出“da” 因为大夫只有一个读法

# ----------------------------------------------------
print(pypinyin.pinyin('朝阳',style=Style.TONE))                   #[['zhāo'], ['yáng']]
print(pypinyin.pinyin('朝阳',style=Style.TONE2))                  #[['zha1o'], ['ya2ng']]
print(pypinyin.pinyin('朝阳',style=Style.TONE3, heteronym=True))  #[['zhao1', 'chao2'], ['yang2']]
print(pypinyin.pinyin('朝阳',style=Style.FIRST_LETTER))           #[['z'], ['y']]  #首字母风格，只返回拼音的首字母部分
print(pypinyin.pinyin('朝阳',style=Style.INITIALS))               #[['zh'], ['']]       #声母风格，只返回各个拼音的声母部分（注：有的拼音没有声母)


# ==================================================================================

# def lazy_pinyin(hans, style=Style.NORMAL, errors='default', strict=True)

# 有没有一个方法直接给我们一个一维列表呢，我们可以使用 lazy_pinyin 方法来实现（lazy_pinyin 方法默认使用了 NORMAL，即无声调的风格模式）;不考虑多音字；
word4 = pypinyin.lazy_pinyin('你好')
print(word4)
# ['ni', 'hao']

# ----------------------------------------------------
print(pypinyin.lazy_pinyin('中国', style=Style.NORMAL))           #['zhong', 'guo']
print(pypinyin.lazy_pinyin('中国', style=Style.TONE2))            #['zho1ng', 'guo2']
print(pypinyin.lazy_pinyin('中国', style=Style.TONE3))            #['zhong1', 'guo2']
print(pypinyin.lazy_pinyin('中国', style=Style.FIRST_LETTER))     #['z', 'g']     #首字母风格，只返回拼音的首字母部分
print(pypinyin.lazy_pinyin('中国', style=Style.INITIALS))         #['zh', 'g']   #声母风格，只返回各个拼音的声母部分（注：有的拼音没有声母)
print(pypinyin.lazy_pinyin('战略', v_to_u=True))                  #['zhan', 'lüe']  ## 不使用 v 表示 ü
print(pypinyin.lazy_pinyin('衣裳', style=Style.TONE3, neutral_tone_with_five=True))     #['yi1', 'shang5']    # 使用 5 标识轻声
#-----------------------------------------------------


#===============================================================================
# 处理不包含拼音的字符
print(pypinyin.pinyin('你好☆☆'))                              #[['nǐ'], ['hǎo'], ['☆☆']]   #默认不作任何处理，原样返回；
print(pypinyin.pinyin('你好☆☆', errors='ignore'))             # [['nǐ'], ['hǎo']]   #忽略
print(pypinyin.pinyin('你好☆☆',errors='replace'))             #[['nǐ'], ['hǎo'], ['26062606']]   # 替换为去掉 \u 的 unicode 编码

#callable 对象 : 提供一个回调函数，接受无拼音字符(串)作为参数, 支持的返回值类型: unicode 或 list 或 None 。:
print(pypinyin.pinyin('你好☆☆', errors=lambda x: 'star'))     #[['nǐ'], ['hǎo'], ['star']]
print(pypinyin.pinyin('你好☆☆', errors=lambda x: None))       #[['nǐ'], ['hǎo']]

# 返回值类型为 list 时，会自动 expend list
print(pypinyin.pinyin('你好☆☆', errors=lambda x: ['star' for _ in x]))                            #[['nǐ'], ['hǎo'], ['star'], ['star']]
print(pypinyin.pinyin('你好☆☆', heteronym=True, errors=lambda x: [['star', '☆'] for _ in x]))     #[['nǐ'], ['hǎo'], ['star', '☆'], ['star', '☆']]