NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #3213 most downloaded on PyPI
汉字拼音转换模块/工具.
Last release 1 years ago
20 Jul 2025
Ships fairly regularly
a new release about every 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
97 releases · first in 2013
[Changed] 分离词组库中包含中文逗号的词语(via f097b6a _)
[Changed] 分离词组库中包含中文逗号的词语(via f097b6a)
[Changed] 使用 `pinyin-data`_ v0.3.0 的拼音数据
[Bugfixed] 修复一些词语存在拼音粘连在一起的情况. (#41_ thanks @jolly-tao_ )
[Bugfixed] 修复一些词语存在拼音粘连在一起的情况. (`#41`_ thanks `@jolly-tao`_ )
One column per quarter.
[Changed] 单个汉字的拼音数据改为使用来自 pinyin-data_ 的拼音数据。
[Changed] 单个汉字的拼音数据改为使用来自 `pinyin-data`_ 的拼音数据。
[New] 命令行程序支持从标准输入读取汉字信息:
$ echo "你好" | pypinyin nǐ hǎo $ pypinyin < hello.txt nǐ hǎo
[Bugfixed] 更新 phrases_dict 修复类似 #36_ 的问题。thanks @someus_
[Bugfixed] 更新 phrases_dict 修复类似 `#36`_ 的问题。thanks `@someus`_
[Changed] 分割 __init__.py 为 compat.py, constants.py, core.py 和 utils.py。 影响: __init__.py 中只保留文档中提到过的 api, 如果使用了不在文档中的 api 则需要调整代码。
[Changed] 分割 __init__.py 为 compat.py, constants.py, core.py 和 utils.py。 影响: __init__.py 中只保留文档中提到过的 api, 如果使用了不在文档中的 api 则需要调整代码。
[New] Python 3.3++++ 以上版本默认支持 U++++20000 ~ U++++2FA1F 区间内的汉字(详见 #33_)
[New] Python 3.3++++ 以上版本默认支持 U++++20000 ~ U++++2FA1F 区间内的汉字(详见 `#33`_)
[Bugfixed] 修复未正确处理鼻音(详见 汉语拼音 - 维基百科_ )的问题(#31_ thanks @xulin97_ ):
[Bugfixed] 修复未正确处理鼻音(详见 `汉语拼音 - 维基百科`_ )的问题(`#31`_ thanks `@xulin97`_ ):
ḿ、ń、ň、ǹ 对应 “呒”、“呣”、“唔”、“嗯”等字。 这些字之前在各种风格下都输出原始的汉字而不是拼音。
* [Improved] 细微调整,主要是更新文档
[Improved] 细微调整,主要是更新文档
[Bugfixed] Fixed Python 3 compatibility was broken.
[Bugfixed] Fixed Python 3 compatibility was broken.
[New] load_single_dict 和 load_phrases_dict 增加 style 参数支持 TONE2 风格的拼音 ::
[New] load_single_dict 和 load_phrases_dict 增加 style 参数支持 TONE2 风格的拼音
load_single_dict({ord(u'啊'): 'a1'}, style='tone2')
load_phrases_dict({u"阿爸": [[u"a1"], [u"ba4"]]}, style='tone2'}
[Improved] Improved docs
[Bugfixed][Changed] 修复 ju, qu, xu, yu, yi 和 wu 的韵母( #26_ ). Thanks @MingStar_ :
[Bugfixed][Changed] 修复 ju, qu, xu, yu, yi 和 wu 的韵母( `#26`_ ). Thanks `@MingStar`_ :
ju, qu, xu 的韵母应该是 v
yi 的韵母是 i
wu 的韵母是 u
从现在开始 y 既不是声母也不是韵母,详见 `汉语拼音方案`_
[Changed] 将拼音词典库里的国际音标字母替换为 ASCII 字母. Thanks @MingStar_ :
[Changed] 将拼音词典库里的国际音标字母替换为 ASCII 字母. Thanks `@MingStar`_ :
ɑ -> a
ɡ -> g
[Bugfixed] 修复 zh, ch, sh, z, c, s 顺序问题导致获取声母有误
[Bugfixed] 修复 zh, ch, sh, z, c, s 顺序问题导致获取声母有误
[Changed] y, w 也不是声母. (hotoo/pinyin#57 __):
[Changed] y, w 也不是声母. (hotoo/pinyin#57):
以 y, w 开头的拼音在声母(INITIALS)模式下将返回 ['']
[Improved] 上传到 PyPI 出了点问题,但是又 没法重新上传 __ ,只好新增一个版本
[Improved] 上传到 PyPI 出了点问题,但是又 没法重新上传 ,只好新增一个版本
[Bugfixed][Changed] 修复误把 yu 放入声母列表里的 BUG(#22_). Thanks @MingStar_
[Bugfixed][Changed] 修复误把 yu 放入声母列表里的 BUG(`#22`_). Thanks `@MingStar`_
[Bugfixed] 重构内置的分词功能,修复“无法正确处理包含空格的字符串的问题”
[Bugfixed] 重构内置的分词功能,修复“无法正确处理包含空格的字符串的问题”
[New] 内置简单的分词功能,完善处理没有拼音的字符 (如果不需要处理多音字问题, 现在可以不用安装 jieba 或其他分词模块了)::
[New] 内置简单的分词功能,完善处理没有拼音的字符 (如果不需要处理多音字问题, 现在可以不用安装 jieba 或其他分词模块了):
# 之前, 安装了结巴分词模块 lazy_pinyin(u'你好abc☆☆') [u'ni', u'hao', 'a', 'b', 'c', u'\u2606', u'\u2606'] # 现在, 无论是否安装结巴分词模块 lazy_pinyin(u'你好abc☆☆') [u'ni', u'hao', u'abc\u2606\u2606']
[Changed] 将英文字符也纳入 errors 参数的处理范围:
# 之前 lazy_pinyin(u'abc', errors='ignore') [u'abc'] # 现在 lazy_pinyin(u'abc', errors='ignore') []
[Bugfixed] Python 2 下无法使用 from pypinyin import * 的问题
[Bugfixed] Python 2 下无法使用 from pypinyin import * 的问题
[New] 支持以下环境变量:
PYPINYIN_NO_JIEBA=true: 禁用“自动调用结巴分词模块”
PYPINYIN_NO_PHRASES=true: 禁用内置的“词组拼音库”
[New] errors 参数支持回调函数(#17_): ::
[New] errors 参数支持回调函数(`#17`_):
def foobar(char):
return u'a'
pinyin(u'あ', errors=foobar)
* [Bugfixed] 纠正包含 "便宜" 的一些词组的读音
[Bugfixed] 纠正包含 "便宜" 的一些词组的读音
[Bugfixed] "苹果" pinyin error. #11__
[Bugfixed] "苹果" pinyin error. #11
[Bugfixed] 重复 import jieba 的问题
[Improved] 精简 phrases_dict
[Improved] 更新文档
* [Bugfixed] phrases_dict error
[Bugfixed] phrases_dict error
[Bugfixed] 无法正确处理由分词模块产生的中英文混合词组(比如:B超,维生素C)的问题. #8__
[Bugfixed] 无法正确处理由分词模块产生的中英文混合词组(比如:B超,维生素C)的问题. #8
* [Improved] 更新拼音库
[Improved] 更新拼音库
[Improved] 载入拼音库时,改为载入其副本。防止内置的拼音库被破坏
[Improved] 载入拼音库时,改为载入其副本。防止内置的拼音库被破坏
[Bugfixed] 胜败乃兵家常事 的音标问题
[New] 参数 errors 用来控制如何处理没有拼音的字符:
[New] 参数 errors 用来控制如何处理没有拼音的字符:
'default': 保留原始字符
'ignore': 忽略该字符
'replace': 替换为去掉 \u 的 unicode 编码字符串(u'\u90aa' => u'90aa')
只处理 [^a-zA-Z0-9_] 字符。
* [Changed] 使用新的单字拼音库内容和格式 | 新的格式:{0x963F: u"ā,ē"} | 旧的格式:{u'啊': u"ā,ē"}
[Changed] 使用新的单字拼音库内容和格式
[Bugfixed] “ImportError: No module named runner”
[Improved] 清理命令行命令的输出结果,去除无关信息
[Bugfixed] “ImportError: No module named runner”
[Bugfixed] 命令行工具在 Python 3 下的兼容性问题
[Bugfixed] 命令行工具在 Python 3 下的兼容性问题
[Changed] 拼音风格前的 STYLE_ 前缀(兼容包含 STYLE_ 前缀的拼音风格)
[Changed] 拼音风格前的 STYLE_ 前缀(兼容包含 STYLE_ 前缀的拼音风格)
[New] 命令行工具,具体用法请见: pypinyin -h
[New] 支持自定义拼音库,方便用户修正程序结果(load_single_dict, load_phrases_dict)
[New] 支持自定义拼音库,方便用户修正程序结果(load_single_dict, load_phrases_dict)
[Changed] 将 jieba 模块改为可选安装,用户可以选择使用自己喜爱的分词模块对汉字进行分词处理
[Changed] 将 jieba 模块改为可选安装,用户可以选择使用自己喜爱的分词模块对汉字进行分词处理
[New] 支持 Python 3
>>> lazy_pinyin(u'中心') ['zhong', 'xin']
[New] lazy_pinyin
>>> lazy_pinyin(u'中心') ['zhong', 'xin']
pypinyin.STYLE_FINALS : 韵母风格1,只返回各个拼音的韵母部分,不带声调。如: ong uo
[Bugfixed] 首字母风格无法正确处理只有韵母的汉字
pypinyin.STYLE_FINALS : 韵母风格1,只返回各个拼音的韵母部分,不带声调。如: ong uo
pypinyin.STYLE_FINALS_TONE : 韵母风格2,带声调,声调在韵母第一个字母上。如: ōng uó
pypinyin.STYLE_FINALS_TONE2 : 韵母风格2,带声调,声调在各个拼音之后,用数字 [0-4] 进行表示。如: o1ng uo2
>> pypinyin.pinyin(u'你好abc') [[u'n\u01d0'], [u'h\u01ceo'], [u'abc']]
[Improved] 完善对中英文混合字符串的支持:
>> pypinyin.pinyin(u'你好abc') [[u'n\u01d0'], [u'h\u01ceo'], [u'abc']]
.. _#17: https://github.com/mozillazg/python-pinyin/pull/17 .. _#22: https://github.com/mozillazg/python-pinyin/pull/22 .. _#26: https://github.com/mo
[New] Initial Release
Your coding agent can read these notes before it upgrades. Set up the MCP server →