Python pypinyin库实现汉字转拼音的全面使用指南

pip install pypinyin

import pypinyin
from pypinyin import Style

# 标准声调风格（默认）
print(pypinyin.pinyin("中心"))  # 输出：[['zhōng'], ['xīn']]

# 首字母风格
print(pypinyin.pinyin("中心", style=Style.FIRST_LETTER))  # 输出：[['z'], ['x']]

# 拼音后标数字声调
print(pypinyin.pinyin("中心", style=Style.TONE3))  # 输出：[['zhong1'], ['xin1']]

# 无声调普通风格
print(pypinyin.lazy_pinyin("中心", style=Style.NORMAL))  # 输出：['zhong', 'xin']

# 启用多音字模式
print(pypinyin.pinyin("行", heteronym=True))  # 输出：[['háng', 'xíng', 'héng', 'hàng']]

# 多字多音字处理
print(pypinyin.pinyin("银行", heteronym=True))  # 输出：[['yín'], ['háng', 'xíng', 'héng', 'hàng']]

# 基础使用
print(pypinyin.lazy_pinyin("中心"))  # 输出：['zhong', 'xin']

# 带声调的 lazy 模式
print(pypinyin.lazy_pinyin("中心", style=Style.TONE))  # 输出：['zhōng', 'xīn']

# 声调变调处理（如"你好"的"好"变调）
print(pypinyin.lazy_pinyin("你好", style=Style.TONE2, tone_sandhi=True))  # 输出：['ni2', 'ha3o']

# 保留原始字符（默认）
print(pypinyin.lazy_pinyin("中国abc123"))  # 输出：['zhong', 'guo', 'a', 'b', 'c', '1', '2', '3']

# 忽略无拼音字符
print(pypinyin.lazy_pinyin("中国abc123", errors="ignore"))  # 输出：['zhong', 'guo']

# 替换为 unicode 编码（去掉\u）
print(pypinyin.lazy_pinyin("中国✨123", errors="replace"))  # 输出：['zhong', 'guo', '2728', '1', '2', '3']

# 默认用 v 表示 ü
print(pypinyin.lazy_pinyin("战略"))  # 输出：['zhan', 'lve']

# 用 ü 代替 v
print(pypinyin.lazy_pinyin("战略", v_to_u=True))  # 输出：['zhan', 'lüe']

# 轻声用 5 标识
print(pypinyin.lazy_pinyin("衣裳", style=Style.TONE3, neutral_tone_with_five=True))  # 输出：['yi1', 'shang5']

# 默认分隔符 "-"
print(pypinyin.slug("中国人"))  # 输出：'zhong-guo-ren'

# 自定义分隔符为空格
print(pypinyin.slug("中国人", separator=" "))  # 输出：'zhong guo ren'

# 首字母拼接
print(pypinyin.slug("中国人", style=Style.FIRST_LETTER, separator=""))  # 输出：'zgr'

# 俄语字母风格
print(pypinyin.slug("中国人", style=Style.CYRILLIC))  # 输出：'чжун1-го2-жэнь2'

# 自定义单字拼音库：{汉字Unicode编码: 拼音字符串}
custom_single = {0x82f1: "yīng"}  # 0x82f1 是"英"的 Unicode 编码
pypinyin.load_single_dict(custom_single)

print(pypinyin.lazy_pinyin("英"))  # 输出：['yīng']

# 自定义词语拼音库：{词语: [[字1拼音], [字2拼音]]}
custom_phrases = {"阿爸": [["ā"], ["bà"]]}
pypinyin.load_phrases_dict(custom_phrases)

print(pypinyin.pinyin("阿爸"))  # 输出：[['ā'], ['bà']]

from pypinyin.style import register

# 注册自定义风格：返回拼音大写形式
@register("upper")
def upper_style(pinyin, **kwargs):
    return pinyin.upper()

# 使用自定义风格
print(pypinyin.lazy_pinyin("中心", style="upper"))  # 输出：['ZHONG', 'XIN']

# 带声调的大写风格
print(pypinyin.lazy_pinyin("中心", style="upper", style=Style.TONE))  # 输出：['ZHŌNG', 'XĪN']