Python pypinyin库使用指南：多音字、风格转换与自定义词典

周予安

发布时间：2026-10-14 | 6人浏览过

原创

本文详细介绍Python第三方库pypinyin的安装与核心用法。涵盖智能匹配拼音、多音字与繁体字支持，详解Style类中的14种拼音风格（如声调、注音、俄语对照等）。通过示例演示如何处理非汉字字符，并利用load_phrases_dict方法自定义词典以修正特定词汇的拼音标注，实现精准的中文转拼音功能。

一、前言

首先推荐一个中文官方网站，供读者深入查阅相关资料。

https://pypi.org/project/pypinyin/

pypinyin库具备以下主要特性：

能够智能匹配最准确的拼音结果；
支持多音字及繁体字的转换；
兼容多种不同的拼音和注音风格。

由于该库属于第三方Python库，使用前需先完成安装。


pip install pypinyin

安装完成后，直接导入该库即可使用。


import pypinyin
from pypinyin import pinyin

二、pypinyin库的使用

首先展示一个最基础的使用示例。


from pypinyin import pinyin
pinyin("吃饭")

运行结果如下：

部分汉字存在多音字情况，接着看下面的例子。


from pypinyin import pinyin
pinyin('冯',heteronym=True)
pinyin('朝',heteronym=True)
pinyin('同',heteronym=True)

运行结果如下：

观察上述打印结果，生成的是二维列表嵌套结构，解析起来较为繁琐。

能否生成一维列表呢？


from pypinyin import lazy_pinyin
lazy_pinyin("数据分析与统计学之美")

运行结果如下：

新的问题随之出现。

虽然结果是一维列表，但丢失了声调信息，这显然不够理想。

这里涉及风格转换的问题。


from pypinyin import lazy_pinyin,Style
lazy_pinyin("数据分析与统计学之美",style=Style.TONE)

运行结果如下：

原来这里有一个Style类，供我们选择风格，常用的风格有下面这14种。


#: 普通风格，不带声调。如： 中国 -> ``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

如果文字中除了汉字，还有其它符号以及英文，会打印出怎么样的效果呢？


from pypinyin import lazy_pinyin
lazy_pinyin('Hello，我是😀',style=Style.TONE)

运行结果如下：

汉字打印出来就行，英文、表情符号不用打印出来最好，应该怎么办呢？

这里有一个errors参数呢，来看看例子。


from pypinyin import lazy_pinyin

lazy_pinyin('Hello，我是😀',style=Style.TONE,errors='ignore')

运行结果如下：

如果你对pypinyin库的返回结果不满意，可以自定义一个库呀！这里可以使用load_phrases_dict 方法。

我们先来看一个例子：


from pypinyin import lazy_pinyin

lazy_pinyin("黄同学",style=Style.TONE)

运行结果如下：

“黄同学” 的同，明明是二声，这里成了四声。


from pypinyin import lazy_pinyin,  load_phrases_dict

personalized_dict = {'黄同学':  [['huáng'], ['tòng'], ['xué']]}

load_phrases_dict(personalized_dict)

lazy_pinyin("黄同学",style=Style.TONE)

运行结果如下：