汉字拼音转换工具（Python 版）

将汉字转为拼音。可以用于汉字注音、排序、检索(Russian translation) 。

最初版本的代码参考了 hotoo/pinyin 的实现。

• Documentation: http://pypinyin.rtfd.io

• GitHub: https://github.com/mozillazg/python-pinyin

• License: MIT license

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

• Python version: 2.7, pypy, pypy3, 3.4, 3.5, 3.6, 3.7, 3.8, 3.9

特性

• 根据词组智能匹配最正确的拼音。

• 支持多音字。

• 简单的繁体支持, 注音支持。

• 支持多种不同拼音风格。

Contents

• 安装
• 使用
  • 示例
  • 处理不包含拼音的字符
  • 自定义拼音库
  • 自定义拼音风格
  • strict 参数的影响
  • 命令行工具
    • pypinyin
    • toneconvert
• API
  • 拼音风格
    • Style
      • Style.NORMAL
      • Style.TONE
      • Style.TONE2
      • Style.TONE3
      • Style.INITIALS
      • Style.FIRST_LETTER
      • Style.FINALS
      • Style.FINALS_TONE
      • Style.FINALS_TONE2
      • Style.FINALS_TONE3
      • Style.BOPOMOFO
      • Style.BOPOMOFO_FIRST
      • Style.CYRILLIC
      • Style.CYRILLIC_FIRST
      • Style.WADEGILES
  • 核心 API
    • pinyin()
    • lazy_pinyin()
    • load_single_dict()
    • load_phrases_dict()
    • slug()
  • 注册新的拼音风格
    • register()
• contrib
  • 拼音转换
    • to_normal()
    • to_tone()
    • to_tone2()
    • to_tone3()
    • to_initials()
    • to_finals()
    • to_finals_tone()
    • to_finals_tone2()
    • to_finals_tone3()
• 开发文档
  • 准备开发环境
  • 测试
  • 目录结构
  • 实现思路/主逻辑
  • 发布新版本
• FAQ
  • 拼音有误？
  • 如何禁用内置的“词组拼音库”
  • 如何禁用默认的“拼音库”copy 操作
  • 如何减少内存占用
  • INITIALS 声母风格下，以 y, w, yu 开头的汉字返回空字符串
  • 存在既没有声母也没有韵母的拼音？
  • 如何将某一风格的拼音转换为其他风格的拼音？
• Related Projects
• Changelog
  • 0.52.0 (2024-08-04)
  • 0.51.0 (2024-03-10)
  • 0.50.0 (2023-12-11)
  • 0.49.0 (2023-05-14)
  • 0.48.0 (2023-01-15)
  • 0.47.1 (2022-08-21)
  • 0.47.0 (2022-07-30)
  • 0.46.0 (2022-02-12)
  • 0.45.0 (2022-01-23)
  • 0.44.0 (2021-11-14)
  • 0.43.0 (2021-10-06)
  • 0.42.1 (2021-09-30)
  • 0.42.0 (2021-06-14)
  • 0.41.0 (2021-03-13)
  • 0.40.0 (2020-11-22)
  • 0.39.1 (2020-10-08)
  • 0.39.0 (2020-08-16)
  • 0.38.1 (2020-07-05)
  • 0.38.0 (2020-06-07)
  • 0.37.0 (2020-02-09)
  • 0.36.0 (2019-10-27)
  • 0.35.4 (2019-07-13)
  • 0.35.3 (2019-05-11)
  • 0.35.2 (2019-04-06)
  • 0.35.1 (2019-03-02)
  • 0.35.0 (2019-02-24)
  • 0.34.1 (2018-12-30)
  • 0.34.0 (2018-12-08)
    • 不兼容旧版的变更
  • 0.33.2 (2018-11-03)
  • 0.33.1 (2018-09-23)
  • 0.33.0 (2018-08-05)
  • 0.32.0 (2018-07-28)
  • 0.31.0 (2018-06-10)
  • 0.30.1 (2018-04-25)
  • 0.30.0 (2018-02-03)
  • 0.29.0 (2018-01-14)
  • 0.28.0 (2017-12-08)
  • 0.27.0 (2017-10-28)
  • 0.26.1 (2017-10-25)
  • 0.26.0 (2017-10-12)
  • 0.25.0 (2017-10-01)
  • 0.24.0 (2017-09-17)
  • 0.23.0 (2017-07-09)
  • 0.22.0 (2017-06-14)
  • 0.21.1 (2017-05-29)
  • 0.21.0 (2017-05-14)
  • 0.20.0 (2017-05-13)
  • 0.19.0 (2017-05-05)
  • 0.18.2 (2017-04-25)
  • 0.18.1 (2017-03-22)
  • 0.18.0 (2017-03-22)
  • 0.17.0 (2017-03-13)
  • 0.16.1 (2017-02-12)
  • 0.16.0 (2016-11-27)
  • 0.15.0 (2016-10-18)
  • 0.14.0 (2016-09-24)
  • 0.13.0 (2016-08-19)
  • 0.12.1 (2016-05-11)
  • 0.12.0 (2016-03-12)
  • 0.11.1 (2016-02-17)
  • 0.11.0 (2016-01-16)
  • 0.10.0 (2016-01-02)
  • 0.9.5 (2015-12-19)
  • 0.9.4 (2015-11-27)
  • 0.9.3 (2015-11-15)
  • 0.9.2 (2015-11-15)
  • 0.9.1 (2015-10-17)
  • 0.9.0 (2015-09-20)
  • 0.8.5 (2015-08-23)
  • 0.8.4 (2015-08-23)
  • 0.8.3 (2015-08-20)
  • 0.8.2 (2015-08-20)
  • 0.8.1 (2015-07-04)
  • 0.8.0 (2015-06-27)
  • 0.7.0 (2015-06-20)
  • 0.6.0 (2015-06-10)
  • 0.5.7 (2015-05-17)
  • 0.5.6 (2015-02-26)
  • 0.5.5 (2015-01-27)
  • 0.5.4 (2014-12-26)
  • 0.5.3 (2014-12-07)
  • 0.5.2 (2014-09-21)
  • 0.5.1 (2014-03-09)
  • 0.5.0 (2014-03-01)
  • 0.4.4 (2014-01-16)
  • 0.4.3 (2014-01-10)
  • 0.4.2 (2014-01-10)
  • 0.4.1 (2014-01-04)
  • 0.4.0 (2014-01-03)
  • 0.3.1 (2013-12-24)
  • 0.3.0 (2013-09-26)
  • 0.2.0 (2013-09-22)
  • 0.1.0 (2013-09-21)

Indices and tables

• 索引

• 模块索引

• 搜索页面