Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/mozillazg/go-pinyin
汉字转拼音
https://github.com/mozillazg/go-pinyin
chinese go golang hanzi hanzi-pinyin pinyin
Last synced: 1 day ago
JSON representation
汉字转拼音
- Host: GitHub
- URL: https://github.com/mozillazg/go-pinyin
- Owner: mozillazg
- License: mit
- Created: 2014-11-09T14:04:33.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2023-07-12T14:32:55.000Z (over 1 year ago)
- Last Synced: 2025-01-02T21:11:37.454Z (9 days ago)
- Topics: chinese, go, golang, hanzi, hanzi-pinyin, pinyin
- Language: Go
- Homepage: https://godoc.org/github.com/mozillazg/go-pinyin
- Size: 2.26 MB
- Stars: 1,647
- Watchers: 42
- Forks: 196
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-go - go-pinyin - CN Hanzi to Hanyu Pinyin converter. (Natural Language Processing / Translation)
- zero-alloc-awesome-go - go-pinyin - CN Hanzi to Hanyu Pinyin converter. (Natural Language Processing / Translation)
- awesome - mozillazg/go-pinyin - 汉字转拼音 (Go)
- go-awesome - go-pinyin - Go version of Chinese Pinyin conversion tool (Open source library / Word Processing)
- awesome-go - go-pinyin - CN Hanzi to Hanyu Pinyin converter. Stars:`1.6K`. (Natural Language Processing / Translation)
- awesome-golang-repositories - go-pinyin
- awesome-go - go-pinyin - 汉字转拼音 - ★ 395 (Natural Language Processing)
- awesome-go-extra - go-pinyin - 11-09T14:04:33Z|2022-03-06T14:06:53Z| (Bot Building / Translation)
- awesome-go-zh - go-pinyin
README
go-pinyin
=========
[](https://github.com/mozillazg/go-pinyin/actions/workflows/ci.yml)
[](https://coveralls.io/r/mozillazg/go-pinyin?branch=master)
[](https://goreportcard.com/report/github.com/mozillazg/go-pinyin)
[](https://godoc.org/github.com/mozillazg/go-pinyin)
汉语拼音转换工具 Go 版。
Installation
------------
```
go get github.com/mozillazg/go-pinyin
```
install CLI tool:
```
# go version>=1.17
go install github.com/mozillazg/go-pinyin/cli/pinyin@latest
# go version<1.17
go get -u github.com/mozillazg/go-pinyin/cli/pinyin
$ pinyin 中国人
zhōng guó rén
```
Documentation
--------------
API documentation can be found here:
https://godoc.org/github.com/mozillazg/go-pinyin
Usage
------
```go
package main
import (
"fmt"
"github.com/mozillazg/go-pinyin"
)
func main() {
hans := "中国人"
// 默认
a := pinyin.NewArgs()
fmt.Println(pinyin.Pinyin(hans, a))
// [[zhong] [guo] [ren]]
// 包含声调
a.Style = pinyin.Tone
fmt.Println(pinyin.Pinyin(hans, a))
// [[zhōng] [guó] [rén]]
// 声调用数字表示
a.Style = pinyin.Tone2
fmt.Println(pinyin.Pinyin(hans, a))
// [[zho1ng] [guo2] [re2n]]
// 开启多音字模式
a = pinyin.NewArgs()
a.Heteronym = true
fmt.Println(pinyin.Pinyin(hans, a))
// [[zhong zhong] [guo] [ren]]
a.Style = pinyin.Tone2
fmt.Println(pinyin.Pinyin(hans, a))
// [[zho1ng zho4ng] [guo2] [re2n]]
fmt.Println(pinyin.LazyPinyin(hans, pinyin.NewArgs()))
// [zhong guo ren]
fmt.Println(pinyin.Convert(hans, nil))
// [[zhong] [guo] [ren]]
fmt.Println(pinyin.LazyConvert(hans, nil))
// [zhong guo ren]
}
```
注意：
* 默认情况下会忽略没有拼音的字符（可以通过自定义 `Fallback` 参数的值来自定义如何处理没有拼音的字符，
详见 [示例](https://godoc.org/github.com/mozillazg/go-pinyin#example-Pinyin--FallbackCustom1)）。
* 根据 [《汉语拼音方案》](http://www.moe.gov.cn/s78/A19/yxs_left/moe_810/s230/195802/t19580201_186000.html) y，w，ü (yu) 都不是声母，
以及不是所有拼音都有声母，如果这不是你预期的话，你可能需要的是首字母风格 `FirstLetter`
（ [详细信息](https://github.com/mozillazg/python-pinyin#%E4%B8%BA%E4%BB%80%E4%B9%88%E6%B2%A1%E6%9C%89-y-w-yu-%E5%87%A0%E4%B8%AA%E5%A3%B0%E6%AF%8D) ）。
Related Projects
-----------------
* [hotoo/pinyin](https://github.com/hotoo/pinyin): 汉语拼音转换工具 Node.js/JavaScript 版。
* [mozillazg/python-pinyin](https://github.com/mozillazg/python-pinyin): 汉语拼音转换工具 Python 版。
* [mozillazg/rust-pinyin](https://github.com/mozillazg/rust-pinyin): 汉语拼音转换工具 Rust 版。
pinyin data
-----------------
* 使用 [pinyin-data](https://github.com/mozillazg/pinyin-data) 的拼音数据
License
---------
Under the MIT License.